core/model/modx/processors/system/action/create.class.php
Create an action
- Package
- modx
- $controller
- string
The controller location
- $loadheaders
- boolean
Whether or not to load header templates for the action
- $namespace
- string
The namespace for the action
- $lang_topics
- string
The lexicon topics for the action
- $assets
- string
- $parent
- integer
(optional) The parent for the action. Defaults to 0.
- Subpackage
- processors.system.action
\modActionCreateProcessor
Create an action
{@inheritdoc}
- Parent(s)
- \modObjectCreateProcessor < \modObjectProcessor < \modProcessor
- $controller
- string
The controller location
- $loadheaders
- boolean
Whether or not to load header templates for the action
- $namespace
- string
The namespace for the action
- $lang_topics
- string
The lexicon topics for the action
- $assets
- string
- $parent
- integer
(optional) The parent for the action. Defaults to 0.
Properties
string
$afterSaveEvent= ''''
''
Details- Type
- string
- Inherited_from
- \modObjectCreateProcessor::$$afterSaveEvent
string
$beforeSaveEvent= ''''
''
Details- Type
- string
- Inherited_from
- \modObjectCreateProcessor::$$beforeSaveEvent
string
$classKey= ''modAction''
'modAction'
Details- Type
- string
array
$languageTopics= 'array('action','menu','namespace')'
array('action','menu','namespace')
Details- Type
- array
\modX
$modx= 'null'
A reference to the modX object.
Inherited from: \modProcessor::$$modx\modObjectProcessor::$$modx\modObjectCreateProcessor::$$modxnull
Details- Type
- \modX
- Inherited_from
- \modProcessor::$$modx
- Inherited_from
- \modObjectProcessor::$$modx
- Inherited_from
- \modObjectCreateProcessor::$$modx
\xPDOObject|\modAccessibleObject
$object= ''
- Type
- \xPDOObject | \modAccessibleObject
- Inherited_from
- \modObjectProcessor::$$object
- Inherited_from
- \modObjectCreateProcessor::$$object
string
$objectType= ''object''
'object'
Details- Type
- string
- Inherited_from
- \modObjectProcessor::$$objectType
- Inherited_from
- \modObjectCreateProcessor::$$objectType
string
$path= ''''
The absolute path to this processor
Inherited from: \modProcessor::$$path\modObjectProcessor::$$path\modObjectCreateProcessor::$$path''
Details- Type
- string
- Inherited_from
- \modProcessor::$$path
- Inherited_from
- \modObjectProcessor::$$path
- Inherited_from
- \modObjectCreateProcessor::$$path
string
$permission= ''actions''
'actions'
Details- Type
- string
string
$primaryKeyField= ''id''
'id'
Details- Type
- string
- Inherited_from
- \modObjectProcessor::$$primaryKeyField
- Inherited_from
- \modObjectCreateProcessor::$$primaryKeyField
array
$properties= 'array()'
The array of properties being passed to this processor
Inherited from: \modProcessor::$$properties\modObjectProcessor::$$properties\modObjectCreateProcessor::$$propertiesarray()
Details- Type
- array
- Inherited_from
- \modProcessor::$$properties
- Inherited_from
- \modObjectProcessor::$$properties
- Inherited_from
- \modObjectCreateProcessor::$$properties
Methods
__construct(
\modX $modx, array $properties
=
array()
)
:
void
Creates a modProcessor object.
Inherited from: \modProcessor::__construct()\modObjectProcessor::__construct()\modObjectCreateProcessor::__construct()Name | Type | Description |
---|---|---|
$modx | \modX | A reference to the modX instance |
$properties | array | An array of properties |
_decodeLiterals(
string $string
)
:
string
Decodes strings encoded by _encodeLiterals to restore JavaScript literals.
Inherited from: \modProcessor::_decodeLiterals()\modObjectProcessor::_decodeLiterals()\modObjectCreateProcessor::_decodeLiterals()Name | Type | Description |
---|---|---|
$string | string | The JSON-encoded string with encoded literals. |
Type | Description |
---|---|
string | The JSON-encoded string with literals restored. |
- Access
- protected
_encodeLiterals(
mixed $value, integer | string $key
)
:
void
Encodes certain JavaScript literal strings for later decoding.
Inherited from: \modProcessor::_encodeLiterals()\modObjectProcessor::_encodeLiterals()\modObjectCreateProcessor::_encodeLiterals()Name | Type | Description |
---|---|---|
$value | mixed | &$value A reference to the value to be encoded if it is identified as a literal. |
$key | integer | string | The array key corresponding to the value. |
- Access
- protected
addFieldError(
string $key, string $message
=
''
)
:
mixed
Add an error to the field
Inherited from: \modProcessor::addFieldError()\modObjectProcessor::addFieldError()\modObjectCreateProcessor::addFieldError()Name | Type | Description |
---|---|---|
$key | string | |
$message | string |
Type | Description |
---|---|
mixed |
afterSave(
)
:
boolean
Override in your derivative class to do functionality before save() is run
Inherited from: \modObjectCreateProcessor::afterSave()Type | Description |
---|---|
boolean |
beforeSave(
)
:
boolean
Override in your derivative class to do functionality after save() is run
Type | Description |
---|---|
boolean |
beforeSet(
)
:
boolean
Override in your derivative class to do functionality before the fields are set on the object
Inherited from: \modObjectCreateProcessor::beforeSet()Type | Description |
---|---|
boolean |
checkPermissions(
)
:
boolean
Return true here to allow access to this processor.
Inherited from: \modObjectProcessor::checkPermissions()\modObjectCreateProcessor::checkPermissions()Type | Description |
---|---|
boolean |
doesAlreadyExist(
array $criteria
)
:
int
Name | Type | Description |
---|---|---|
$criteria | array |
Type | Description |
---|---|
int |
failure(
string $msg
=
'', mixed $object
=
null
)
:
array | string
Return a failure message from the processor.
Inherited from: \modProcessor::failure()\modObjectProcessor::failure()\modObjectCreateProcessor::failure()Name | Type | Description |
---|---|---|
$msg | string | |
$object | mixed |
Type | Description |
---|---|
array | string |
fireBeforeSaveEvent(
)
:
boolean
Fire before save event. Return true to prevent saving.
Inherited from: \modObjectCreateProcessor::fireBeforeSaveEvent()Type | Description |
---|---|
boolean |
getInstance(
\modX $modx, string $className, array $properties
=
array()
)
:
\The
Return the proper instance of the derived class. This can be used to override how MODX loads a processor class; for example, when handling derivative classes with class_key settings.
Inherited from: \modProcessor::getInstance()\modObjectProcessor::getInstance()\modObjectCreateProcessor::getInstance()Name | Type | Description |
---|---|---|
$modx | \modX | A reference to the modX object. |
$className | string | The name of the class that is being requested. |
$properties | array | An array of properties being run with the processor |
Type | Description |
---|---|
\The | class specified by $className |
- Static
getLanguageTopics(
)
:
array
Load a collection of Language Topics for this processor.
Inherited from: \modObjectProcessor::getLanguageTopics()\modObjectCreateProcessor::getLanguageTopics()Override this in your derivative class to provide the array of topics to load.
Type | Description |
---|---|
array |
getProperties(
)
:
array
Get an array of properties for this processor
Inherited from: \modProcessor::getProperties()\modObjectProcessor::getProperties()\modObjectCreateProcessor::getProperties()Type | Description |
---|---|
array |
getProperty(
string $k, mixed $default
=
null
)
:
mixed
Get a specific property.
Inherited from: \modProcessor::getProperty()\modObjectProcessor::getProperty()\modObjectCreateProcessor::getProperty()Name | Type | Description |
---|---|---|
$k | string | |
$default | mixed |
Type | Description |
---|---|
mixed |
hasErrors(
)
:
boolean
Return whether or not the processor has errors
Inherited from: \modProcessor::hasErrors()\modObjectProcessor::hasErrors()\modObjectCreateProcessor::hasErrors()Type | Description |
---|---|
boolean |
initialize(
)
:
boolean
Can be used to provide custom methods prior to processing. Return true to tell MODX that the Processor initialized successfully. If you return anything else, MODX will output that return value as an error message.
Type | Description |
---|---|
boolean |
logManagerAction(
)
:
void
Log the removal manager action
Inherited from: \modObjectCreateProcessor::logManagerAction()outputArray(
array $array, mixed $count
=
false
)
:
string
Return arrays of objects (with count) converted to JSON.
Inherited from: \modProcessor::outputArray()\modObjectProcessor::outputArray()\modObjectCreateProcessor::outputArray()The JSON result includes two main elements, total and results. This format is used for list results.
Name | Type | Description |
---|---|---|
$array | array | An array of data objects. |
$count | mixed | The total number of objects. Used for pagination. |
Type | Description |
---|---|
string | The JSON output. |
- Access
- public
process(
)
:
mixed
Process the Object create processor Run the processor and return the result. Override this in your derivative class to provide custom functionality.
Inherited from: \modObjectCreateProcessor::process()Used here for pre-2.2-style processors.
Type | Description |
---|---|
mixed |
processEventResponse(
array | string $response, string $separator
=
"\n"
)
:
string
Processes a response from a Plugin Event invocation
Inherited from: \modProcessor::processEventResponse()\modObjectProcessor::processEventResponse()\modObjectCreateProcessor::processEventResponse()Name | Type | Description |
---|---|---|
$response | array | string | The response generated by the invokeEvent call |
$separator | string | The separator for each event response |
Type | Description |
---|---|
string | The processed response. |
run(
)
:
\modProcessorResponse
Run the processor, returning a modProcessorResponse object.
Inherited from: \modProcessor::run()\modObjectProcessor::run()\modObjectCreateProcessor::run()Type | Description |
---|---|
\modProcessorResponse |
setCheckbox(
string $k, boolean $force
=
false
)
:
int | null
Special helper method for handling checkboxes. Only set value if passed or $force is true, and check for a not empty value or string 'false'.
Inherited from: \modProcessor::setCheckbox()\modObjectProcessor::setCheckbox()\modObjectCreateProcessor::setCheckbox()Name | Type | Description |
---|---|---|
$k | string | |
$force | boolean |
Type | Description |
---|---|
int | null |
setDefaultProperties(
array $properties
=
array()
)
:
array
Sets default properties that only are set if they don't already exist in the request
Inherited from: \modProcessor::setDefaultProperties()\modObjectProcessor::setDefaultProperties()\modObjectCreateProcessor::setDefaultProperties()Name | Type | Description |
---|---|---|
$properties | array |
Type | Description |
---|---|
array | The newly merged properties array |
setPath(
string $path
)
:
void
Set the path of the processor
Inherited from: \modProcessor::setPath()\modObjectProcessor::setPath()\modObjectCreateProcessor::setPath()Name | Type | Description |
---|---|---|
$path | string | The absolute path |
setProperties(
array $properties
)
:
void
Set the runtime properties for the processor
Inherited from: \modProcessor::setProperties()\modObjectProcessor::setProperties()\modObjectCreateProcessor::setProperties()Name | Type | Description |
---|---|---|
$properties | array | The properties, in array and key-value form, to run on this processor |
setProperty(
string $k, mixed $v
)
:
void
Set a property value
Inherited from: \modProcessor::setProperty()\modObjectProcessor::setProperty()\modObjectCreateProcessor::setProperty()Name | Type | Description |
---|---|---|
$k | string | |
$v | mixed |
success(
string $msg
=
'', mixed $object
=
null
)
:
array | string
Return a success message from the processor.
Inherited from: \modProcessor::success()\modObjectProcessor::success()\modObjectCreateProcessor::success()Name | Type | Description |
---|---|---|
$msg | string | |
$object | mixed |
Type | Description |
---|---|
array | string |
toJSON(
mixed $data
)
:
string
Converts PHP to JSON with JavaScript literals left in-tact.
Inherited from: \modProcessor::toJSON()\modObjectProcessor::toJSON()\modObjectCreateProcessor::toJSON()JSON does not allow JavaScript literals, but this function encodes certain identifiable literals and decodes them back into literals after modX::toJSON() formats the data.
Name | Type | Description |
---|---|---|
$data | mixed | The PHP data to be converted. |
Type | Description |
---|---|
string | The extended JSON-encoded string. |
- Access
- public
unsetProperty(
string $key
)
:
void
Completely unset a property from the properties array
Inherited from: \modProcessor::unsetProperty()\modObjectProcessor::unsetProperty()\modObjectCreateProcessor::unsetProperty()Name | Type | Description |
---|---|---|
$key | string |