PagesNames::uniqueRandomPageName() method

Get a random, globally unique page name

Usage

// basic usage
$string = $pagesNames->uniqueRandomPageName();

// usage with all arguments
$string = $pagesNames->uniqueRandomPageName(array $options = []);

Arguments

NameType(s)Description
options (optional)array
  • page (Page): If name is or should be assigned to a Page, specify it here. (default=null)
  • length (int): Required/fixed length, or omit for random length (default=0).
  • min (int): Minimum required length, if fixed length not specified (default=6).
  • max (int): Maximum allowed length, if fixed length not specified (default=min*2).
  • alpha (bool): Include alpha a-z letters? (default=true)
  • numeric (bool): Include numeric digits 0-9? (default=true)
  • confirm (bool): Confirm that name is globally unique? (default=true)
  • parent (Page|int): If specified, name must only be unique for this parent Page or ID (default=0).
  • prefix (string): Prepend this prefix to page name (default='').
  • suffix (string): Append this suffix to page name (default='').

Return value

string


PagesNames methods and properties

API reference based on ProcessWire core version 3.0.236

Latest news

  • ProcessWire Weekly #555
    In the 555th issue of ProcessWire Weekly we're going to check out the latest core updates, introduce a new third party module that adds the ability to automatically convert email messages to pages, and more. Read on!
    Weekly.pw / 28 December 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 2024
  • Subscribe to weekly ProcessWire news

“We chose ProcessWire because of its excellent architecture, modular extensibility and the internal API. The CMS offers the necessary flexibility and performance for such a complex website like superbude.de. ProcessWire offers options that are only available for larger systems, such as Drupal, and allows a much slimmer development process.” —xport communication GmbH