ResaveElements ​
- Type
- Class
- Namespace
- craft\queue\jobs
- Inherits
- craft\queue\jobs\ResaveElements » craft\queue\BaseBatchedJob » craft\queue\BaseJob » yii\base\BaseObject
- Implements
- craft\queue\JobInterface, yii\base\Configurable
- Since
- 3.0.0
ResaveElements job
Public Properties ​
Property | Description |
---|---|
batchIndex | integer – The index of the current batch (starting with 0 ) |
batchSize | integer – The number of items that should be processed in a single batch |
criteria | array, null – The element criteria that determines which elements should be resaved |
description | string, null – The configured job description. |
elementType | string – The element type that should be resaved |
ifEmpty | boolean – Whether the set attribute should only be set if it doesn’t have a value. |
ifInvalid | boolean – Whether the set attribute should only be set if the current value doesn’t validate. |
itemOffset | integer – The offset to start fetching items by. |
priority | integer, null – The job’s priority |
set | string, null – An attribute name that should be set for each of the elements. |
to | string, null – The value that should be set on the set attribute. |
touch | boolean – Whether to update the dateUpdated timestamp for the elements. |
ttr | integer, null – The job’s TTR |
updateSearchIndex | boolean – Whether to update the search indexes for the resaved elements. |
criteria
​
The element criteria that determines which elements should be resaved
elementType
​
- Type
- string
- Default value
null
The element type that should be resaved
ifEmpty
​
- Type
- boolean
- Default value
false
- Since
- 4.2.6
Whether the set attribute should only be set if it doesn’t have a value.
ifInvalid
​
- Type
- boolean
- Default value
false
- Since
- 4.9.0
Whether the set attribute should only be set if the current value doesn’t validate.
set
​
An attribute name that should be set for each of the elements. The value will be determined by to.
to
​
The value that should be set on the set attribute.
touch
​
- Type
- boolean
- Default value
false
- Since
- 4.2.6
Whether to update the dateUpdated
timestamp for the elements.
updateSearchIndex
​
- Type
- boolean
- Default value
false
- Since
- 3.4.2
Whether to update the search indexes for the resaved elements.
Public Methods ​
Method | Description |
---|---|
__call() | Calls the named method which is not a class method. |
__construct() | Constructor. |
__get() | Returns the value of an object property. |
__isset() | Checks if a property is set, i.e. defined and not null. |
__set() | Sets value of an object property. |
__sleep() | |
__unset() | Sets an object property to null. |
__wakeup() | |
canGetProperty() | Returns a value indicating whether a property can be read. |
canSetProperty() | Returns a value indicating whether a property can be set. |
className() | Returns the fully qualified name of this class. |
execute() | |
getDescription() | Returns the description that should be used for the job. |
hasMethod() | Returns a value indicating whether a method is defined. |
hasProperty() | Returns a value indicating whether a property is defined. |
init() | Initializes the object. |
Protected Methods ​
Method | Description |
---|---|
data() | Returns the batchable data. |
defaultDescription() | Returns a default description for getDescription(). |
loadData() | Loads the batchable data. |
processItem() | Processes an item. |
setProgress() | Sets the job progress on the queue. |
totalBatches() | Returns the total number of batches. |
totalItems() | Returns the total number of items across all the batches. |
defaultDescription()
​
Returns a default description for getDescription().
TIP
Run the description through craft\i18n\Translation::prep() rather than Craft::t() so it can be lazy-translated for users’ preferred languages rather that the current app language.
Returns ​
loadData()
​
Loads the batchable data.
Returns ​
processItem()
​
Processes an item.
Arguments ​
$item
(mixed
)