| Current File : /home/pacjaorg/public_html/nsa/libraries/src/MVC/Model/WorkflowBehaviorTrait.php |
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2020 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE
*/
namespace Joomla\CMS\MVC\Model;
\defined('JPATH_PLATFORM') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Filesystem\Path;
use Joomla\CMS\Form\Form;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\CMS\Workflow\Workflow;
/**
* Trait which supports state behavior
*
* @since 4.0.0
*/
trait WorkflowBehaviorTrait
{
/**
* The name of the component.
*
* @var string
* @since 4.0.0
*/
protected $extension = null;
/**
* The section of the component.
*
* @var string
* @since 4.0.0
*/
protected $section = '';
/**
* Is workflow for this component enabled?
*
* @var boolean
* @since 4.0.0
*/
protected $workflowEnabled = false;
/**
* The workflow object
*
* @var Workflow
* @since 4.0.0
*/
protected $workflow;
/**
* Set Up the workflow
*
* @param string $extension The option and section separated by.
*
* @return void
*
* @since 4.0.0
*/
public function setUpWorkflow($extension)
{
$parts = explode('.', $extension);
$this->extension = array_shift($parts);
if (count($parts))
{
$this->section = array_shift($parts);
}
$this->workflow = new Workflow($extension);
$params = ComponentHelper::getParams($this->extension);
$this->workflowEnabled = $params->get('workflow_enabled');
$this->enableWorkflowBatch();
}
/**
* Add the workflow batch to the command list. Can be overwritten bei the child class
*
* @return void
*
* @since 4.0.0
*/
protected function enableWorkflowBatch()
{
// Enable batch
if ($this->workflowEnabled && property_exists($this, 'batch_commands'))
{
$this->batch_commands['workflowstage_id'] = 'batchWorkflowStage';
}
}
/**
* Method to allow derived classes to preprocess the form.
*
* @param Form $form A Form object.
* @param mixed $data The data expected for the form.
*
* @return void
*
* @since 4.0.0
* @see FormField
*/
public function workflowPreprocessForm(Form $form, $data)
{
$this->addTransitionField($form, $data);
if (!$this->workflowEnabled)
{
return;
}
// Import the workflow plugin group to allow form manipulation.
$this->importWorkflowPlugins();
}
/**
* Let plugins access stage change events
*
* @return void
*
* @since 4.0.0
*/
public function workflowBeforeStageChange()
{
if (!$this->workflowEnabled)
{
return;
}
$this->importWorkflowPlugins();
}
/**
* Preparation of workflow data/plugins
*
* @return void
*
* @since 4.0.0
*/
public function workflowBeforeSave()
{
if (!$this->workflowEnabled)
{
return;
}
$this->importWorkflowPlugins();
}
/**
* Executing of relevant workflow methods
*
* @return void
*
* @since 4.0.0
*/
public function workflowAfterSave($data)
{
// Regardless if workflow is active or not, we have to set the default stage
// So we can work with the workflow, when the user activates it later
$id = $this->getState($this->getName() . '.id');
$isNew = $this->getState($this->getName() . '.new');
// We save the first stage
if ($isNew)
{
// We have to add the paths, because it could be called outside of the extension context
$path = JPATH_BASE . '/components/' . $this->extension;
$path = Path::check($path);
Form::addFormPath($path . '/forms');
Form::addFormPath($path . '/models/forms');
Form::addFieldPath($path . '/models/fields');
Form::addFormPath($path . '/model/form');
Form::addFieldPath($path . '/model/field');
$form = $this->getForm();
$stage_id = $this->getStageForNewItem($form, $data);
$this->workflow->createAssociation($id, $stage_id);
}
if (!$this->workflowEnabled)
{
return;
}
// Execute transition
if (!empty($data['transition']))
{
$this->executeTransition([$id], $data['transition']);
}
}
/**
* Batch change workflow stage or current.
*
* @param integer $value The workflow stage ID.
* @param array $pks An array of row IDs.
* @param array $contexts An array of item contexts.
*
* @return mixed An array of new IDs on success, boolean false on failure.
*
* @since 4.0.0
*/
public function batchWorkflowStage(int $value, array $pks, array $contexts)
{
$user = Factory::getApplication()->getIdentity();
$workflow = Factory::getApplication()->bootComponent('com_workflow');
if (!$user->authorise('core.admin', $this->option))
{
$this->setError(Text::_('JLIB_APPLICATION_ERROR_BATCH_CANNOT_EXECUTE_TRANSITION'));
}
// Get workflow stage information
$stage = $workflow->getMVCFactory()->createTable('Stage', 'Administrator');
if (empty($value) || !$stage->load($value))
{
Factory::getApplication()->enqueueMessage(Text::sprintf('JGLOBAL_BATCH_WORKFLOW_STAGE_ROW_NOT_FOUND'), 'error');
return false;
}
if (empty($pks))
{
Factory::getApplication()->enqueueMessage(Text::sprintf('JGLOBAL_BATCH_WORKFLOW_STAGE_ROW_NOT_FOUND'), 'error');
return false;
}
// Update workflow associations
return $this->workflow->updateAssociations($pks, $value);
}
/**
* Batch change workflow stage or current.
*
* @param integer $oldId The ID of the item copied from
* @param integer $newId The ID of the new item
*
* @return null
*
* @since 4.0.0
*/
public function workflowCleanupBatchMove($oldId, $newId)
{
// Trigger workflow plugins only if enable (will be triggered from parent class)
if ($this->workflowEnabled)
{
$this->importWorkflowPlugins();
}
// We always need an association, so create one
$table = $this->getTable();
$table->load($newId);
$catKey = $table->getColumnAlias('catid');
$stage_id = $this->workflow->getDefaultStageByCategory($table->$catKey);
if (empty($stage_id))
{
return;
}
$this->workflow->createAssociation((int) $newId, (int) $stage_id);
}
/**
* Runs transition for item.
*
* @param array $pks Id of items to execute the transition
* @param integer $transitionId Id of transition
*
* @return boolean
*
* @since 4.0.0
*/
public function executeTransition(array $pks, int $transitionId)
{
$result = $this->workflow->executeTransition($pks, $transitionId);
if (!$result)
{
$app = Factory::getApplication();
$app->enqueueMessage(Text::_('COM_CONTENT_ERROR_UPDATE_STAGE', $app::MSG_WARNING));
return false;
}
return true;
}
/**
* Import the Workflow plugins.
*
* @param Form $form A Form object.
* @param mixed $data The data expected for the form.
*
* @return void
*/
protected function importWorkflowPlugins()
{
PluginHelper::importPlugin('workflow');
}
/**
* Adds a transition field to the form. Can be overwritten by the child class if not needed
*
* @param Form $form A Form object.
* @param mixed $data The data expected for the form.
*
* @return void
* @since 4.0.0
*/
protected function addTransitionField(Form $form, $data)
{
$extension = $this->extension . ($this->section ? '.' . $this->section : '');
$field = new \SimpleXMLElement('<field></field>');
$field->addAttribute('name', 'transition');
$field->addAttribute('type', $this->workflowEnabled ? 'transition' : 'hidden');
$field->addAttribute('label', 'COM_CONTENT_WORKFLOW');
$field->addAttribute('extension', $extension);
$form->setField($field);
$table = $this->getTable();
$key = $table->getKeyName();
$id = isset($data->$key) ? $data->$key : $form->getValue($key);
if ($id)
{
// Transition field
$assoc = $this->workflow->getAssociation($id);
if (!empty($assoc->stage_id))
{
$form->setFieldAttribute('transition', 'workflow_stage', (int) $assoc->stage_id);
}
}
else
{
$stage_id = $this->getStageForNewItem($form, $data);
if (!empty($stage_id))
{
$form->setFieldAttribute('transition', 'workflow_stage', (int) $stage_id);
}
}
}
/**
* Try to load a workflow stage for newly created items
* which does not have a workflow assigned yet. If the category is not the
* carrier, overwrite it on your model and deliver your own carrier.
*
* @param Form $form A Form object.
* @param mixed $data The data expected for the form.
*
* @return boolean|integer An integer, holding the stage ID or false
* @since 4.0.0
*/
protected function getStageForNewItem(Form $form, $data)
{
$table = $this->getTable();
$hasKey = $table->hasField('catid');
if (!$hasKey)
{
return false;
}
$catKey = $table->getColumnAlias('catid');
$field = $form->getField($catKey);
if (!$field)
{
return false;
}
$catId = isset(((object) $data)->$catKey) ? ((object) $data)->$catKey : $form->getValue($catKey);
// Try to get the category from the html code of the field
if (empty($catId))
{
$catId = $field->getAttribute('default', null);
if (!$catId)
{
// Choose the first category available
$catOptions = $field->options;
if ($catOptions && !empty($catOptions[0]->value))
{
$catId = (int) $catOptions[0]->value;
}
}
}
if (empty($catId))
{
return false;
}
return $this->workflow->getDefaultStageByCategory($catId);
}
}