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 #554
    In the 554th issue of ProcessWire Weekly we'll check out the latest core updates, introduce a couple of new third party modules, and more. Read on!
    Weekly.pw / 21 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

“I am currently managing a ProcessWire site with 2 million+ pages. It’s admirably fast, and much, much faster than any other CMS we tested.” —Nickie, Web developer