# grand-media/trunk/admin/processor/class.processor.terms.php

Gmedia Photo Gallery, version trunk. 328 lines.

- Page: https://pluginprobe.com/plugins/grand-media/trunk/code/admin/processor/class.processor.terms.php
- Raw: https://pluginprobe.com/plugins/grand-media/trunk/raw/admin/processor/class.processor.terms.php
- Modified: 2026-09-02T23:00:00+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/grand-media/trunk/code/admin/processor/class.processor.terms.php#L10-L20`.

```php
<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * GmediaProcessor_Terms
 */
class GmediaProcessor_Terms extends GmediaProcessor {

	public static $cookie_key = false;

	private static $me = null;

	public $selected_items = array();
	public $query_args     = array();

	/**
	 * GmediaProcessor_Library constructor.
	 */
	public function __construct() {
		parent::__construct();

		self::$cookie_key = "gmedia_terms:{$this->taxterm}";
		if ( ! isset( $_COOKIE[ self::$cookie_key ] ) ) {
			foreach ( $_COOKIE as $key => $value ) {
				if ( 'gmedia_terms' === substr( $key, 0, 12 ) ) {
					setcookie( $key, '', time() - 3600 );
					unset( $_COOKIE[ $key ] );
				}
			}
		}
		$this->selected_items = parent::selected_items( self::$cookie_key );
	}

	public static function getMe() {
		if ( null === self::$me ) {
			self::$me = new GmediaProcessor_Terms();
		}

		return self::$me;
	}

	protected function processor() {
		global $user_ID, $gmCore, $gmDB;

		if ( ! $gmCore->caps['gmedia_library'] ) {
			wp_die( esc_html__( 'You are not allowed to be here', 'grand-media' ) );
		}

		include_once GMEDIA_ABSPATH . 'admin/pages/terms/functions.php';

		$this->query_args = $this->query_args();

		$taxonomy = $this->taxonomy;
		switch ( $taxonomy ) {
			case 'gmedia_album':
				if ( gm_user_can( 'album_manage' ) ) {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_album_tpl' );
				} else {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_alert_tpl' );
				}
				break;
			case 'gmedia_category':
				if ( gm_user_can( 'category_manage' ) ) {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_category_tpl' );
				} else {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_alert_tpl' );
				}
				break;
			case 'gmedia_tag':
				if ( gm_user_can( 'tag_manage' ) ) {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_tag_tpl' );
				} else {
					add_action( 'gmedia_before_terms_list', 'gmedia_terms_create_alert_tpl' );
				}
				break;
		}

		if ( isset( $_POST['gmedia_album_save'] ) ) {
			check_admin_referer( 'gmedia_terms', '_wpnonce_terms' );
			$edit_term = (int) $gmCore->_get( 'edit_term' );
			do {
				if ( ! $gmCore->caps['gmedia_album_manage'] ) {
					$this->error[] = __( 'You are not allowed to manage albums', 'grand-media' );
					break;
				}
				$term = $gmCore->_post( 'term' );
				$meta = $gmCore->_post( 'meta' );
				if ( $meta ) {
					$term = array_merge_recursive( array( 'meta' => $meta ), $term );
				}
				$term['name'] = trim( $term['name'] );
				if ( empty( $term['name'] ) ) {
					$this->error[] = esc_html__( 'Term Name is not specified', 'grand-media' );
					break;
				}
				if ( $gmCore->is_digit( $term['name'] ) ) {
					$this->error[] = esc_html__( "Term Name can't be only digits", 'grand-media' );
					break;
				}
				$taxonomy = 'gmedia_album';
				if ( $edit_term && ! $gmDB->term_exists( $edit_term ) ) {
					$this->error[] = esc_html__( 'A term with the id provided does not exists', 'grand-media' );
					$edit_term     = false;
				}
				$term_id = $gmDB->term_exists( $term['name'], $taxonomy, $term['global'] );
				if ( $term_id && $term_id !== $edit_term ) {
					$this->error[] = esc_html__( 'A term with the name provided already exists', 'grand-media' );
					break;
				}
				if ( $edit_term ) {
					$_term = $gmDB->get_term( $edit_term );
					if ( ( (int) $_term->global !== (int) $user_ID ) && ! current_user_can( 'gmedia_edit_others_media' ) ) {
						$this->error[] = esc_html__( 'You are not allowed to edit others media', 'grand-media' );
						break;
					}
					$term_id = $gmDB->update_term( $edit_term, $term );
				} else {
					$term_id = $gmDB->insert_term( $term['name'], $term['taxonomy'], $term );
				}
				if ( is_wp_error( $term_id ) ) {
					$this->error[] = $term_id->get_error_message();
					break;
				}
				if ( isset( $term['reset_custom_order'] ) ) {
					$gmDB->update_term_sortorder( $term_id );
				}

				// translators: album name.
				$this->msg[] = sprintf( esc_html__( 'Album `%s` successfully saved', 'grand-media' ), esc_html( $term['name'] ) );

			} while ( 0 );
		} elseif ( isset( $_POST['gmedia_category_save'] ) ) {
			check_admin_referer( 'gmedia_terms', '_wpnonce_terms' );
			$edit_term = (int) $gmCore->_get( 'edit_term' );
			do {
				if ( ! $gmCore->caps['gmedia_category_manage'] ) {
					$this->error[] = __( 'You are not allowed to manage categories', 'grand-media' );
					break;
				}
				$term = $gmCore->_post( 'term' );
				$meta = $gmCore->_post( 'meta' );
				if ( $meta ) {
					$term = array_merge_recursive( array( 'meta' => $meta ), $term );
				}
				$term['name'] = trim( $term['name'] );
				if ( empty( $term['name'] ) ) {
					$this->error[] = esc_html__( 'Term Name is not specified', 'grand-media' );
					break;
				}
				if ( $gmCore->is_digit( $term['name'] ) ) {
					$this->error[] = esc_html__( "Term Name can't be only digits", 'grand-media' );
					break;
				}
				$taxonomy = 'gmedia_category';
				if ( $edit_term && ! $gmDB->term_exists( $edit_term ) ) {
					$this->error[] = esc_html__( 'A term with the id provided does not exists', 'grand-media' );
					$edit_term     = false;
				}
				$term_id = $gmDB->term_exists( $term['name'], $taxonomy );
				if ( $term_id && $term_id !== $edit_term ) {
					$this->error[] = esc_html__( 'A term with the name provided already exists', 'grand-media' );
					break;
				}
				if ( $edit_term ) {
					if ( ! current_user_can( 'gmedia_edit_others_media' ) ) {
						$this->error[] = esc_html__( 'You are not allowed to edit others media', 'grand-media' );
						break;
					}
					$term_id = $gmDB->update_term( $edit_term, $term );
				} else {
					$term_id = $gmDB->insert_term( $term['name'], $term['taxonomy'], $term );
				}
				if ( is_wp_error( $term_id ) ) {
					$this->error[] = $term_id->get_error_message();
					break;
				}

				// translators: category name.
				$this->msg[] = sprintf( esc_html__( 'Category `%s` successfully saved', 'grand-media' ), esc_html( $term['name'] ) );

			} while ( 0 );
		} elseif ( isset( $_POST['gmedia_tag_add'] ) ) {
			if ( $gmCore->caps['gmedia_tag_manage'] ) {
				check_admin_referer( 'gmedia_terms', '_wpnonce_terms' );
				$term        = $gmCore->_post( 'term' );
				$terms       = array_filter( array_map( 'trim', explode( ',', $term['name'] ) ) );
				$terms_added = 0;
				$terms_qty   = count( $terms );
				foreach ( $terms as $term_name ) {
					if ( $gmCore->is_digit( $term_name ) ) {
						$this->error['tag_name_digit'] = esc_html__( "Term Name can't be only digits", 'grand-media' );
						continue;
					}

					if ( ! $gmDB->term_exists( $term_name, $term['taxonomy'] ) ) {
						$term_id = $gmDB->insert_term( $term_name, $term['taxonomy'] );
						if ( is_wp_error( $term_id ) ) {
							$this->error[] = $term_id->get_error_message();
						} else {
							// translators: 1 - number, 2 - number.
							$this->msg['tag_add'] = sprintf( esc_html__( '%1$d of %2$d tags successfully added', 'grand-media' ), ++ $terms_added, $terms_qty );
						}
					} else {
						$this->error['tag_add'] = esc_html__( 'Some of provided tags are already exists', 'grand-media' );
					}
				}
			} else {
				$this->error[] = esc_html__( 'You are not allowed to manage tags', 'grand-media' );
			}
		}

		$do_gmedia_terms = $gmCore->_get( 'do_gmedia_terms' );
		if ( 'delete' === $do_gmedia_terms ) {
			check_admin_referer( 'gmedia_delete', '_wpnonce_delete' );
			if ( $gmCore->caps['gmedia_terms_delete'] ) {
				$ids            = $gmCore->_get( 'ids', 'selected' );
				$selected_items = ( 'selected' === $ids ) ? $this->selected_items : wp_parse_id_list( $ids );
				if ( ! $gmCore->caps['gmedia_delete_others_media'] ) {
					$_selected_items = array();
					if ( 'gmedia_album' === $taxonomy ) {
						$_selected_items = $gmDB->get_terms( $taxonomy, array( 'fields' => 'ids', 'global' => $user_ID, 'include' => $selected_items ) );
					}
					if ( count( $_selected_items ) < count( $selected_items ) ) {
						$this->error[] = __( 'You are not allowed to delete others media', 'grand-media' );
					}
					$selected_items = $_selected_items;
				}
				$count = count( $selected_items );
				if ( $count ) {
					foreach ( $selected_items as $item ) {
						$delete = $gmDB->delete_term( $item );
						if ( ! $delete ) {
							$count --;
						} elseif ( is_wp_error( $delete ) ) {
							$this->error[] = $delete->get_error_message();
							$count --;
						}
					}
					if ( $count ) {
						// translators: number.
						$this->msg[] = sprintf( esc_html__( '%d item(s) deleted successfully', 'grand-media' ), $count );
					}
					setcookie( self::$cookie_key, '', time() - 3600 );
					unset( $_COOKIE[ self::$cookie_key ] );
					$this->selected_items = array();
				}
			} else {
				$this->error[] = esc_html__( 'You are not allowed to delete terms', 'grand-media' );
			}
			if ( ! empty( $this->msg ) ) {
				set_transient( 'gmedia_action_msg', $this->msg, 30 );
			}
			if ( ! empty( $this->error ) ) {
				set_transient( 'gmedia_action_error', $this->error, 30 );
			}
		}
		if ( $do_gmedia_terms ) {
			$_wpnonce = array();
			foreach ( $_GET as $key => $value ) {
				if ( strpos( $key, '_wpnonce' ) !== false ) {
					$_wpnonce[ $key ] = $value;
				}
			}
			$remove_args = array_merge( array( 'do_gmedia_terms', 'ids' ), $_wpnonce );
			$location    = remove_query_arg( $remove_args );
			$location    = add_query_arg( 'did_gmedia_terms', $do_gmedia_terms, $location );
			wp_safe_redirect( $location );
			exit;
		}
		if ( $gmCore->_get( 'did_gmedia_terms' ) ) {
			$msg = get_transient( 'gmedia_action_msg' );
			if ( $msg ) {
				delete_transient( 'gmedia_action_msg' );
				$this->msg = $msg;
			}
			$error = get_transient( 'gmedia_action_error' );
			if ( $error ) {
				delete_transient( 'gmedia_action_error' );
				$this->error = $error;
			}
		}
	}

	/**
	 * @return array
	 */
	public function query_args() {
		global $gmCore;

		$args['status']     = $gmCore->_get( 'status' );
		$args['page']       = $gmCore->_get( 'pager', 1 );
		$args['number']     = $gmCore->_get( 'per_page', $this->user_options["per_page_{$this->taxonomy}"] );
		$args['offset']     = ( $args['page'] - 1 ) * $args['number'];
		$args['global']     = parent::filter_by_author( $gmCore->_get( 'author' ) );
		$args['include']    = $gmCore->_get( 'include' );
		$args['search']     = $gmCore->_get( 's' );
		$args['orderby']    = $gmCore->_get( 'orderby', $this->user_options["orderby_{$this->taxonomy}"] );
		$args['order']      = $gmCore->_get( 'order', $this->user_options["sortorder_{$this->taxonomy}"] );
		$args['hide_empty'] = $gmCore->_get( 'hide_empty' );

		if ( $args['search'] && ( '#' === substr( $args['search'], 0, 1 ) ) ) {
			$args['include'] = substr( $args['search'], 1 );
			$args['search']  = false;
		}

		if ( ( 'selected' === $gmCore->_req( 'filter' ) ) && ! empty( $this->selected_items ) ) {
			$args['include'] = $this->selected_items;
			$args['orderby'] = $gmCore->_get( 'orderby', 'include' );
			$args['order']   = $gmCore->_get( 'order', 'ASC' );
		}

		$query_args = apply_filters( 'gmedia_terms_query_args', $args );

		foreach ( $query_args as $key => $val ) {
			if ( empty( $val ) && ( '0' !== $val ) && ( 0 !== $val ) ) {
				unset( $query_args[ $key ] );
			}
		}

		return $query_args;
	}
}

global $gmProcessorTerms;
$gmProcessorTerms = GmediaProcessor_Terms::getMe();

```