1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 <?php
/**
* TfishTagHandler class file.
*
* @copyright Simon Wilkinson 2013-2017 (https://tuskfish.biz)
* @license https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html GNU General Public License (GPL) V2
* @author Simon Wilkinson <[email protected]>
* @version Release: 1.0
* @since 1.0
* @package content
*/
// Enable strict type declaration.
declare(strict_types=1);
if (!defined("TFISH_ROOT_PATH")) die("TFISH_ERROR_ROOT_PATH_NOT_DEFINED");
/**
* Handler class for tag content objects.
*
* @copyright Simon Wilkinson 2013-2017 (https://tuskfish.biz)
* @license https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html GNU General Public License (GPL) V2
* @author Simon Wilkinson <[email protected]>
* @version Release: 1.0
* @since 1.0
* @package content
*/
class TfishTagHandler extends TfishContentHandler
{
/**
* Count TfishTag objects, optionally matching conditions specified with a TfishCriteria object.
*
* @param object $criteria TfishCriteria object used to build conditional database query.
* @return int $count Number of TfishTagObjects that match the criteria.
*/
public static function getCount(TfishCriteria $criteria = null)
{
if (!isset($criteria)) {
$criteria = new TfishCriteria();
}
// Unset any pre-existing object type criteria.
$type_key = self::getTypeIndex($criteria->item);
if (isset($type_key)) {
$criteria->killType($type_key);
}
// Set new type criteria specific to this object.
$criteria->add(new TfishCriteriaItem('type', 'TfishTag'));
$count = parent::getcount($criteria);
return $count;
}
/**
* Get TfishTag objects, optionally matching conditions specified with a TfishCriteria object.
*
* Note that the object type is automatically set, so it is unnecessary to set it when calling
* TfishTagHandler::getObjects($criteria). However, if you want to use the generic handler
* TfishContentHandler::getObjects($criteria) then you do need to specify the object type,
* otherwise you will get all types of content returned. It is acceptable to use either handler,
* although good practice to use the type-specific one when you know you want a specific kind of
* object.
*
* @param object $criteria TfishCriteria object used to build conditional database query.
* @return array $objects Array of TfishTag objects.
*/
public static function getObjects(TfishCriteria $criteria = null)
{
if (!isset($criteria)) {
$criteria = new TfishCriteria();
}
// Unset any pre-existing object type criteria.
$type_key = self::getTypeIndex($criteria->item);
if (isset($type_key)) {
$criteria->killType($type_key);
}
// Set new type criteria specific to this object.
$criteria->add(new TfishCriteriaItem('type', 'TfishTag'));
$objects = parent::getObjects($criteria);
return $objects;
}
/**
* Generates a tag select box control.
*
* Use the $online_only parameter to control whether you retrieve all tags, or just those marked
* as online. Essentially this provides a way to keep your select box uncluttered; mark tags
* that are not important enough to serve as navigation elements as 'offline'. They are still
* available, but they won't appear in the select box list.
*
* @param int $selected ID of selected option.
* @param string $type Type of content object, eg. TfishArticle.
* @param string $zero_option The string that will be displayed for the 'zero' or no selection
* option.
* @param bool $online_only Get all tags or just those marked online.
* @return bool|string False if no tags or a HTML select box if there are.
*/
public static function getTagSelectBox(int $selected = null, string $type = '',
string $zero_option = TFISH_SELECT_TAGS, bool $online_only = true)
{
$select_box = '';
$tag_list = array();
$clean_selected = (isset($selected) && TfishFilter::isInt($selected, 1))
? (int) $selected : null;
$clean_zero_option = TfishFilter::escape(TfishFilter::trimString($zero_option));
$clean_type = TfishContentHandler::isSanctionedType($type)
? TfishFilter::trimString($type) : null;
$clean_online_only = TfishFilter::isBool($online_only) ? (bool) $online_only : true;
$tag_list = TfishContentHandler::getActiveTagList($clean_type, $clean_online_only);
if ($tag_list) {
$select_box = self::getArbitraryTagSelectBox($clean_selected, $tag_list, 'tag_id', $clean_zero_option);
} else {
$select_box = false;
}
return $select_box;
}
/**
* Build a select box from an arbitrary array of tags.
*
* Use this when you need to customise a tag select box. Pass in an array of the tags you want
* to use as $tag_list as key => value pairs. If you have multiple select boxes on one page then
* you need to assign them different keys and listen for matching input parameters. If you have
* organised tags into collections, you can run a query to retrieve that subset using the
* parental ID as a selection criteria.
*
* @param int $selected ID of selected option.
* @param array $tag_list Array of options in tag_id => title format.
* @param string $key_name The input parameter name you want to use as key for this select box.
* Defaults to 'tag_id'.
* @param string $zero_option The string that will be displayed for the 'zero' or no selection
* option.
* @return string HTML select box.
*/
public static function getArbitraryTagSelectBox($selected = null, $tag_list = array(),
$key_name = null, $zero_option = TFISH_SELECT_TAGS)
{
// Initialise variables.
$select_box = '';
$clean_key_name = '';
$clean_tag_list = array();
// Validate input.
// ID of a previously selected tag, if any.
$clean_selected = (isset($selected) && TfishFilter::isInt($selected, 1))
? (int) $selected : null;
if (TfishFilter::isArray($tag_list) && !empty($tag_list)) {
asort($tag_list);
foreach ($tag_list as $key => $value) {
$clean_key = (int) $key;
$clean_value = TfishFilter::escape(TfishFilter::trimString($value));
$clean_tag_list[$clean_key] = $clean_value;
unset($key, $clean_key, $value, $clean_value);
}
}
// The text to display in the zero option of the select box.
$clean_zero_option = TfishFilter::escape(TfishFilter::trimString($zero_option));
$clean_key_name = isset($key_name)
? TfishFilter::escape(TfishFilter::trimString($key_name)) : 'tag_id';
// Build the select box.
$clean_tag_list = array(0 => $clean_zero_option) + $clean_tag_list;
$select_box = '<select class="form-control custom-select" name="' . $clean_key_name . '" id="'
. $clean_key_name . '" onchange="this.form.submit()">';
foreach ($clean_tag_list as $key => $value) {
$select_box .= ($key === $selected) ? '<option value="' . $key . '" selected>' . $value
. '</option>' : '<option value="' . $key . '">' . $value . '</option>';
}
$select_box .= '</select>';
return $select_box;
}
}