modResource.duplicate

Последнее обновление Oct 11th, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$194 per month—let's make that $500!

Learn more

modResource.duplicate¶

Создаёт копию ресурса со свежим ID. pagetitle сохраняется, если не переданы newName или prefixDuplicate, а поля публикации следуют publishedMode. Значения Template Variables и членство в группах ресурсов тоже копируются.

Возвращает новый modResource, строку лексикона resource_err_duplicate, если копию не удалось сохранить, либо false вне modX. Дочерние ресурсы дублируются рекурсивно, пока не отключено duplicateChildren; рекурсия останавливается, если у пользователя нет политики add_children.

Синтаксис¶

mixed duplicate ([array $options = array()])

newName (string) pagetitle для копии
prefixDuplicate (boolean) добавить к pagetitle префикс из записи лексикона duplicate_of
publishedMode (string) preserve (по умолчанию), publish или unpublish
overrides (array) значения полей, накладываемые на копию
parent (int) родитель копии, по умолчанию тот же родитель
preserve_alias (boolean) оставить исходный alias вместо его пересборки, по умолчанию false
preserve_menuindex (boolean) оставить исходный menuindex вместо дописывания в конец, по умолчанию false
global_duplicate_uri_check (boolean) проверять уникальность alias во всех контекстах, по умолчанию false
duplicateChildren (boolean) дублировать и потомков, по умолчанию true

Пример¶

$resource = $modx->getObject('modResource', array('id' => 5));
$copy = $resource->duplicate(array(
    'newName' => 'foobar copy',
    'publishedMode' => 'unpublish',
));

Смотрите также¶