ShuffleSubqueueItems.php in Entityqueue 8

Namespace

Drupal\entityqueue\Plugin\RulesAction

File

src/Plugin/RulesAction/ShuffleSubqueueItems.php

<?php

namespace Drupal\entityqueue\Plugin\RulesAction;

use Drupal\entityqueue\Entity\EntitySubqueue;
use Drupal\rules\Core\RulesActionBase;

/**
 * Provides a 'Shuffle subqueue items' action.
 *
 * @RulesAction(
 *   id = "entityqueue_shuffle_items",
 *   label = @Translation("Shuffle subqueue items"),
 *   category = @Translation("Entityqueue"),
 *   context_definitions = {
 *     "subqueue" = @ContextDefinition("string",
 *       label = @Translation("Subqueue"),
 *       description = @Translation("Specifies the ID of the subqueue whose items will be shuffled.")
 *     )
 *   }
 * )
 */
class ShuffleSubqueueItems extends RulesActionBase {

  /**
   * Shuffles the items of a  subqueue.
   *
   * @param string $subqueue_id
   *   The ID of the subqueue whose items will be shuffled.
   */
  protected function doExecute($subqueue_id) {

    /** @var \Drupal\entityqueue\EntitySubqueueInterface $subqueue */
    $subqueue = EntitySubqueue::load($subqueue_id);
    $subqueue
      ->shuffleItems()
      ->save();
  }

}

Classes

Name	Description
ShuffleSubqueueItems	Provides a 'Shuffle subqueue items' action.