ProcessWire API Reference

API Variables


Primary

NameSummary
$pageClass used by all Page objects in ProcessWire.
$pagesEnables loading and manipulation of Page objects, to and from the database.
$modulesLoads and manages all modules in ProcessWire.
$userThe $user API variable is a type of page representing the current user, and the User class is Page type used for all users.

Input & Output

NameSummary
$inputProvides a means to get user input from URLs, GET, POST, and COOKIE variables and more.
$sanitizerProvides methods for sanitizing and validating user input, preparing data for output, and more.
$sessionMaintains sessions in ProcessWire, authentication, persistent variables, notices and redirects.
$logEnables creation of logs, logging of events, and management of logs.

Users & Access

NameSummary
$userThe $user API variable is a type of page representing the current user, and the User class is Page type used for all users.
$usersManages all users (User objects) in ProcessWire.
$permissionsProvides management of all Permission pages independent of users, for access control.
$rolesProvides management of all Role pages for access control.

Utilities & Helpers

NameSummary
$cacheProvides easy, persistent caching of markup, strings, arrays or PageArray objects.
$datetimeThe $datetime API variable provides helpers for working with dates/times and conversion between formats.
$filesHelpers for working with files and directories.
$mailProvides an API interface to email and WireMail.

System

NameSummary
$configHolds ProcessWire configuration settings as defined in /wire/config.php and /site/config.php.
$databaseAll database operations in ProcessWire are performed via this PDO-style database class.
$fieldsManages all custom fields in ProcessWire, independently of any Fieldgroup.
$templatesManages and provides access to all the Templates.
$languagesAPI variable $languages enables access to all Language pages and various helper methods.
$classLoaderThe ProcessWire $classLoader API variable handles autoloading of classes and modules.
$urlsMaintains lists of file paths or URLs, primarily used by the ProcessWire $config->paths and $urls API variables.

Functions

View summary of all functions or jump directly to a function by clicking on it below:


Functions-API

cache(), config(), database(), datetime(), fields(), files(), input(), languages(), modules(), page(), pages(), paths(), permissions(), region(), roles(), sanitizer(), session(), setting(), templates(), urls(), user(), users(), wire()


Arrays

PageArray(), WireArray(), WireData()


Class-helpers

wireClassExists(), wireClassImplements(), wireClassName(), wireClassParents(), wireInstanceOf(), wireIsCallable(), wireMethodExists()


Common

wire(), wireCount(), wireDate(), wireInstance(), wireMail()


Files

wireChmod(), wireCopy(), wireIconMarkupFile(), wireIncludeFile(), wireMkdir(), wireRenderFile(), wireRmdir(), wireSendFile(), wireTempDir(), wireUnzipFile(), wireZipFile()


Markup

wireIconMarkup(), wireIconMarkupFile()


Strings

wireBytesStr(), wireDate(), wirePopulateStringTags(), wireRelativeTimeStr()


Translation

__(), _n(), _x()

Core Classes


Primary

NameSummary
WireWire is the base class for most ProcessWire classes and modules.
WireDataWireData is the base data-storage class used by many ProcessWire object types and most modules.
WireArrayWireArray is the base iterable array type used throughout the ProcessWire framework.

Pages

NameSummary
PageClass used by all Page objects in ProcessWire.
NullPageNullPage is a type of Page object returned by many API methods to indicate a non-match.
UserThe $user API variable is a type of page representing the current user, and the User class is Page type used for all users.
RoleRole is a type of Page used for grouping permissions to users.
PermissionPermission is a Page type used for storing an individual permission.

Arrays

NameSummary
WireArrayWireArray is the base iterable array type used throughout the ProcessWire framework.
PageArrayPageArray is a paginated type of WireArray that holds multiple Page objects.
PaginatedArrayPaginatedArray is a type of WireArray that supports pagination of items within it.

Modules

NameSummary
ModuleModule is the primary PHP interface for module types in ProcessWire.
FieldtypeFieldtype is a module type used to represent a type of field. All Fieldtype modules descend from this.
InputfieldInputfield is the base class for modules that collect user input for fields.
ProcessProcess modules are self contained applications that run in the ProcessWire admin.
TextformatterA simple module type that provides formatting of text fields.

Files & Images

NameSummary
PagefileRepresents a single file item attached to a page, typically via a File Fieldtype.
PagefilesPagefiles is a type of WireArray that contains Pagefile objects. It also acts as the value for multi-file fields in ProcessWire.
PageimageRepresents an image item attached to a page, typically via an Image Fieldtype.
PageimagesPageimages are a type of WireArray containing Pageimage objects. They represent the value of multi-image field in ProcessWire.
PagefilesManagerManages files and file directories for a page independent of a particular field.

Fields & Templates

NameSummary
FieldField represents a custom field that is used on a Page.
FieldgroupFieldgroup is a type of WireArray that holds a group of Field objects for template(s).
TemplateTemplate is a Page’s connection to fields (via a Fieldgroup), access control, and output via a template file.

Additional

NameSummary
HookEventHookEvent is a type provided to hook functions with information about the event.
InputfieldWrapperA type of Inputfield that contains other Inputfield objects as children. Commonly a form or a fieldset.
WireHttpWireHttp enables you to send HTTP requests to URLs, download files, and more.
WireMailA module type that handles sending of email in ProcessWire
SessionCSRFProvides an API for cross site request forgery protection.
ProcessWireRepresents an instance of ProcessWire connected with a set of API variables.
PagesTypeProvides an interface to the Pages class but specific to a given page class/type, with predefined parent and template.
SelectorSelector maintains a single selector consisting of field name, operator, and value.
SelectorsProcesses a selector string into a WireArray of Selector objects.
WireDatabaseBackupProcessWire Database Backup and Restore
MarkupPagerNavPager (Pagination) Navigation: Module for generating pagination markup automatically for paginated WireArray types.
PathsMaintains lists of file paths or URLs, primarily used by the ProcessWire $config->paths and $urls API variables.

Twitter updates

  • ProcessWire 3.0.142 has a lot of updates but the biggest is the addition of custom fields support for file and image fields. In this post, we take a closer look at that, and also outline all of the new features in the just-released FormBuilder v40— More
    11 October 2019
  • This week’s dev branch version brings you improvements to ProcessWire’s input->cookie API variable, plus it adds the ability to modify system URLs and paths at runtime. This post also includes some examples to demonstrate just how useful this can be— More
    20 September 2019
  • New post: This week we’ll take a look at a new version of FormBuilder that's on the way (with a screencast), as well as the latest version of the core: ProcessWire 3.0.140— More
    6 September 2019

Latest news

  • ProcessWire Weekly #283
    The 283rd issue of ProcessWire Weekly introduces ProcessWire 3.0.142 and FormBuilder v40, highlights some conference content, and features a new weekly poll continuing with the #processwireworks theme. Read on!
    Weekly.pw / 12 October 2019
  • ProcessWire 3.0.142 core updates
    This latest version of the core on the dev branch has a lot of updates, bnd the biggest is the addition of custom fields support for file and image fields. In this post, we take a closer look and also outline all of the new features in the just-released FormBuilder v40.
    Blog / 11 October 2019
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.