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.244

Latest news

  • ProcessWire Weekly #559
    The 559th issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 25 January 2025
  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

“We were really happy to build our new portfolio website on ProcessWire! We wanted something that gave us plenty of control on the back-end, without any bloat on the front end - just a nice, easy to access API for all our content that left us free to design and build however we liked.” —Castus, web design agency in Sheffield, UK