felixarntz/plugin-lib

View on GitHub
src/db-objects/managers/term-manager.php

Summary

Maintainability
A
55 mins
Test Coverage
<?php
/**
 * Manager class for terms
 *
 * @package Leaves_And_Love\Plugin_Lib
 * @since 1.0.0
 */

namespace Leaves_And_Love\Plugin_Lib\DB_Objects\Managers;

use Leaves_And_Love\Plugin_Lib\DB_Objects\Traits\Meta_Manager_Trait;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Traits\Title_Manager_Trait;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Traits\Content_Manager_Trait;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Traits\Slug_Manager_Trait;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Traits\Type_Manager_Trait;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Models\Term;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Collections\Term_Collection;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Queries\Term_Query;
use Leaves_And_Love\Plugin_Lib\DB_Objects\Model_Type_Managers\Taxonomy_Manager;
use Leaves_And_Love\Plugin_Lib\Translations\Translations_Term_Manager;
use Leaves_And_Love\Plugin_Lib\DB;
use Leaves_And_Love\Plugin_Lib\Cache;
use Leaves_And_Love\Plugin_Lib\Meta;
use Leaves_And_Love\Plugin_Lib\Error_Handler;

if ( ! class_exists( 'Leaves_And_Love\Plugin_Lib\DB_Objects\Managers\Term_Manager' ) ) :

    /**
     * Class for a terms manager
     *
     * This class represents a terms manager.
     *
     * @since 1.0.0
     */
    class Term_Manager extends Core_Manager {
        use Meta_Manager_Trait, Title_Manager_Trait, Content_Manager_Trait, Slug_Manager_Trait, Type_Manager_Trait;

        /**
         * Constructor.
         *
         * @since 1.0.0
         *
         * @param string                    $prefix       The instance prefix.
         * @param array                     $services     {
         *     Array of service instances.
         *
         *     @type DB               $db            The database instance.
         *     @type Cache            $cache         The cache instance.
         *     @type Meta             $meta          The meta instance.
         *     @type Taxonomy_Manager $types         The type manager instance.
         *     @type Error_Handler    $error_handler The error handler instance.
         * }
         * @param Translations_Term_Manager $translations Translations instance.
         */
        public function __construct( $prefix, $services, $translations ) {
            $this->class_name            = Term::class;
            $this->collection_class_name = Term_Collection::class;
            $this->query_class_name      = Term_Query::class;

            $this->singular_slug = 'term';
            $this->plural_slug   = 'terms';

            $this->table_name       = 'terms';
            $this->cache_group      = 'terms';
            $this->meta_type        = 'term';
            $this->fetch_callback   = 'get_term';
            $this->primary_property = 'term_id';
            $this->title_property   = 'name';
            $this->content_property = 'description';
            $this->slug_property    = 'slug';
            $this->type_property    = 'taxonomy';

            $this->public = true;

            parent::__construct( $prefix, $services, $translations );
        }

        /**
         * Internal method to insert a new term into the database.
         *
         * @since 1.0.0
         *
         * @param array $args Array of column => value pairs for the new database row.
         * @return int|false The ID of the new term, or false on failure.
         */
        protected function insert_into_db( $args ) {
            if ( ! isset( $args['name'] ) || ! isset( $args['taxonomy'] ) ) {
                return false;
            }

            $name = $args['name'];
            unset( $args['name'] );

            $taxonomy = $args['taxonomy'];
            unset( $args['taxonomy'] );

            $result = wp_insert_term( $name, $taxonomy, $args );
            if ( is_wp_error( $result ) ) {
                return false;
            }

            return $result['term_id'];
        }

        /**
         * Internal method to update an existing term in the database.
         *
         * @since 1.0.0
         *
         * @param int   $term_id ID of the term to update.
         * @param array $args    Array of column => value pairs to update in the database row.
         * @return bool True on success, or false on failure.
         */
        protected function update_in_db( $term_id, $args ) {
            if ( isset( $args['taxonomy'] ) ) {
                $taxonomy = $args['taxonomy'];
                unset( $args['taxonomy'] );
            } else {
                $term = get_term( $term_id );
                if ( ! $term || is_wp_error( $term ) ) {
                    return false;
                }

                $taxonomy = $term->taxonomy;
            }

            $result = wp_update_term( $term_id, $taxonomy, $args );
            if ( is_wp_error( $result ) ) {
                return false;
            }

            return true;
        }

        /**
         * Internal method to delete a term from the database.
         *
         * @since 1.0.0
         *
         * @param int $term_id ID of the term to delete.
         * @return bool True on success, or false on failure.
         */
        protected function delete_from_db( $term_id ) {
            $term = get_term( $term_id );
            if ( ! $term || is_wp_error( $term ) ) {
                return false;
            }

            $result = wp_delete_term( $term_id, $term->taxonomy );
            if ( ! $result || is_wp_error( $result ) ) {
                return false;
            }

            return true;
        }
    }

endif;