mirror of
https://github.com/farmOS/farmOS.git
synced 2024-02-23 11:37:38 +01:00
73 lines
1.9 KiB
PHP
73 lines
1.9 KiB
PHP
<?php
|
|
|
|
namespace Drupal\farm_group;
|
|
|
|
use Drupal\asset\Entity\AssetInterface;
|
|
use Drupal\log\Entity\LogInterface;
|
|
|
|
/**
|
|
* Asset group membership logic.
|
|
*/
|
|
interface GroupMembershipInterface {
|
|
|
|
/**
|
|
* Build a list of group options for use in form select fields.
|
|
*
|
|
* @param bool $archived
|
|
* Whether or not to include archived groups. Defaults to FALSE. If TRUE,
|
|
* both active and archived groups will be included in the list.
|
|
*
|
|
* @return array
|
|
* Returns an array of group labels keyed by asset ID for use in a form.
|
|
*/
|
|
public function groupOptions($archived = FALSE): array;
|
|
|
|
/**
|
|
* Check if an asset is a member of a group.
|
|
*
|
|
* @param \Drupal\asset\Entity\AssetInterface $asset
|
|
* The Asset entity.
|
|
*
|
|
* @return bool
|
|
* Returns TRUE if the asset is a member of a group, FALSE otherwise.
|
|
*/
|
|
public function hasGroup(AssetInterface $asset): bool;
|
|
|
|
/**
|
|
* Get group assets that an asset is a member of.
|
|
*
|
|
* @param \Drupal\asset\Entity\AssetInterface $asset
|
|
* The Asset entity.
|
|
*
|
|
* @return array
|
|
* Returns an array of assets.
|
|
*/
|
|
public function getGroup(AssetInterface $asset): array;
|
|
|
|
/**
|
|
* Find the latest group assignment log that references an asset.
|
|
*
|
|
* @param \Drupal\asset\Entity\AssetInterface $asset
|
|
* The asset entity.
|
|
*
|
|
* @return \Drupal\log\Entity\LogInterface|null
|
|
* A log entity, or NULL if no logs were found.
|
|
*/
|
|
public function getGroupAssignmentLog(AssetInterface $asset): ?LogInterface;
|
|
|
|
/**
|
|
* Get assets that are members of a group.
|
|
*
|
|
* @param \Drupal\asset\Entity\AssetInterface $group
|
|
* The Asset entity.
|
|
* @param bool $recurse
|
|
* Boolean: whether or not to recurse and load members of sub-groups.
|
|
* Defaults to TRUE.
|
|
*
|
|
* @return array
|
|
* Returns an array of assets.
|
|
*/
|
|
public function getGroupMembers(AssetInterface $group, bool $recurse = TRUE): array;
|
|
|
|
}
|