EE_Shortcodes

Complexity

Total Complexity

35

Size/Duplication

Total Lines	432
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	4

Importance

Changes

0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
A	_set_defaults()	0	6	1
A	_set_shortcode_helper()	0	5	1
A	get_shortcode_helper()	0	7	2
B	parser()	0	24	3
A	get_shortcodes()	0	9	1
	_init_props()	0	1	?
	_parser()	0	1	?
C	_validate_list_requirements()	0	29	7
A	_get_shortcode_attrs()	0	12	2
B	_mutate_conditional_block_in_template()	0	20	6
B	_get_conditional_block_regex()	0	42	2
B	_set_messages_properties()	0	11	5
A	get_set_message_type()	0	4	1
A	get_set_messenger()	0	4	1
A	get_set_context()	0	4	1
A	get_set_message()	0	4	1

<?php

if (! defined('EVENT_ESPRESSO_VERSION')) {
    exit('NO direct script access allowed');
}

/**
 * Event Espresso
 * Event Registration and Management Plugin for WordPress
 * @ package            Event Espresso
 * @ author                Seth Shoultes
 * @ copyright        (c) 2008-2011 Event Espresso  All Rights Reserved.
 * @ license            http://eventespresso.com/support/terms-conditions/   * see Plugin Licensing *
 * @ link                http://www.eventespresso.com
 * @ version            4.0
 * ------------------------------------------------------------------------
 * EE_Shortcodes
 * This is the parent class for the shortcodes libraries.  All common methods, properties are defined in here.
 * The way this library works is a child class would be for defining a logical "grouping" of shortcodes (i.e.
 * 'payment', 'address', 'attendee', 'event' etc.).  The child class extends this parent and then that grouping of
 * shortcodes can be retrieved wherever they are needed. This library takes care of defining shortcodes and their
 * descriptions and also the parsers for those shortcodes.
 *
 * @abstract
 * @package        Event Espresso
 * @subpackage     libraries/shortcodes/EE_Shortcodes.lib.php
 * @author         Darren Ethier
 *                 ------------------------------------------------------------------------
 */
abstract class EE_Shortcodes extends EE_Base
{

    /**
     * holds label for library
     * This is used for referencing the library label
     *
     * @access public
     * @var string
     */
    public $label;


    /**
     * This property is used for referencing a short description of the library
     *
     * @access public
     * @var string
     */
    public $description;


    /**
     * This will hold an array of shortcodes with the key as the shortcode ([shortcode]) and the value as a
     * label/description for the shortcode.
     *
     * @access protected
     * @var array
     */
    protected $_shortcodes;


    /**
     * This will hold the incoming data item sent to the parser method
     *
     * @access protected
     * @var mixed (array|object)
     */
    protected $_data;


    /**
     * some shortcodes may require extra data to parse.  This property is provided for that.
     *
     * @var array
     */
    protected $_extra_data;


    /**
     * EE_messenger used to generate the template being parsed.
     *
     * @since 4.5.0
     * @var EE_messenger
     */
    protected $_messenger;


    /**
     * message type used to generate the template being parsed.
     *
     * @since 4.5.0
     * @var EE_message_type
     */
    protected $_message_type;


    /**
     * context used for the template being parsed
     *
     * @since 4.5.0
     * @var string
     */
    protected $_context;


    /**
     * Specific Message Template Group ID
     *
     * @since 4.5.0
     * @var int
     */
    protected $_GRP_ID;


    /**
     * @since 4.9.0
     * @type EE_Message
     */
    protected $_message;


    /**
     * This will hold an instance of the EEH_Parse_Shortcodes helper that will be used when handling list type
     * shortcodes
     *
     * @var EEH_Parse_Shortcodes
     */
    protected $_shortcode_helper;


    public function __construct()
    {
        $this->_set_defaults();
        $this->_init_props();
    }


    /**
     * This sets the defaults for the properties.  Child classes will override these properties in their _init_props
     * method
     */
    private function _set_defaults()
    {
        $this->name        = $this->description = '';

The property name does not exist on object<EE_Shortcodes>. Since you implemented __set, maybe consider adding a @property annotation.

        $this->_shortcodes = array();
        $this->_set_shortcode_helper();
    }


    /**
     * loads an instance of the EE_Shortcode_Parser helper when requested
     */
    protected function _set_shortcode_helper()
    {
        //get shortcode_replace instance- set when _get_messages is called in child...
        $this->_shortcode_helper = new EEH_Parse_Shortcodes();
    }


    public function get_shortcode_helper()
    {
        if (! $this->_shortcode_helper instanceof EEH_Parse_Shortcodes) {
            $this->_set_shortcode_helper();
        }
        return $this->_shortcode_helper;
    }


    /**
     * This is the public method for kicking of the parser included with each child.  It can be overridden by child
     * classes if necessary (see EE_Questions_Answers for example)
     *
     * @param  string               $shortcode  incoming shortcode to be parsed
     * @param  mixed (object|array) $data       incoming data to be be used for parsing
     * @param  mixed (object|array) $extra_data extra incoming data (usually EE_Messages_Addressee)
     * @return string            parsed shortcode.
     */
    public function parser($shortcode, $data, $extra_data = array())
    {

        //filter setup shortcodes
        $this->_shortcodes = $this->get_shortcodes();

        //we need to setup any dynamic shortcodes so that they work with the array_key_exists
        $sc           = preg_match_all('/(\[[A-Za-z0-9\_]+_\*)/', $shortcode, $matches);

$sc is not used, you could remove the assignment.

        $sc_to_verify = ! empty($matches[0]) ? $matches[0][0] . ']' : $shortcode;

        //first we want to make sure this is a valid shortcode
        if (! array_key_exists($sc_to_verify, $this->_shortcodes)) {
            return false;

The return type of return false; (false) is incompatible with the return type documented by EE_Shortcodes::parser of type string.

        } //get out, this parser doesn't handle the incoming shortcode.
        $this->_data       = $data;
        $this->_extra_data = $extra_data;
        $this->_set_messages_properties();
        $parsed = apply_filters('FHEE__' . get_class($this) . '__parser_after', $this->_parser($shortcode), $shortcode,
            $data, $extra_data, $this);

        //note the below filter applies to ALL shortcode parsers... be careful!
        $parsed = apply_filters('FHEE__EE_Shortcodes__parser_after', $parsed, $shortcode, $data, $extra_data, $this);
        return $parsed;
    }


    /**
     * This method just returns the shortcodes in the $_shortcodes array property.
     *
     * @access public
     * @return array array of shortcodes => description pairs
     */
    public function get_shortcodes()
    {
        $this->_shortcodes = apply_filters('FHEE__' . get_class($this) . '__shortcodes', $this->_shortcodes, $this);

        //note the below filter applies to ALL shortcode parsers... be careful!
        $this->_shortcodes = apply_filters('FHEE__EE_Shortcodes__shortcodes', $this->_shortcodes, $this);

        return $this->_shortcodes;
    }


    /**
     * Child classes use this method to set the $name, $description, and $_shortcodes properties.
     *
     * @abstract
     * @access protected
     * @return void
     */
    abstract protected function _init_props();


    /**
     * This method will give parsing instructions for each shortcode defined in the _shortcodes array.  Child methods
     * will have to take care of handling.
     *
     * @abstract
     * @access protected
     * @param string               $shortcode the shortcode to be parsed.
     * @param mixed (object|array) $data      incoming data for the parser.  The data could be either an object or
     *                             array because there are some shortcodes that might be replaced by prepared data that
     *                             has multiple items in a list (i.e. list of attendees in an event and we're showing
     *                             fname/lname for each attendee).  In this case data will be in an array.  Otherwise
     *                             the data shoudl be in a properly formatted object.  The
     *                             EEH_Parse_Shortcodes.helper.php describes the data object we're expecting.
     * @return string parsed shortcode
     */
    abstract protected function _parser($shortcode);


    /**
     * This just validates incoming data for list type shortcode parsers (and they call this method) to make sure it
     * meets their requirements
     *
     * @return mixed (void|exception) If validation fails we'll throw an exception.
     */
    protected function _validate_list_requirements()
    {

        //first test to make sure we've got an array!
        if (! is_array($this->_data)) {
            throw new EE_Error(sprintf(__('Expecting an array for the data sent to %s. Instead it was %s',
                'event_espresso'), get_class($this), gettype($this->_data)));
        }

        //next test to make sure we've got the required template in the index!
        if (! isset($this->_data['template'])) {
            throw new EE_Error(sprintf(__('The incoming data does not have the required template index in its array',
                'event_espresso')));
        }

        //next test to make sure we've got got a data index in the incoming data array
        if (! isset($this->_data['data'])) {
            throw new EE_Error(__('The incoming data does not have the required data index in its array',
                'event_espresso'));
        }

        //all is well let's make sure _extra_data always has the values needed.
        //let's make sure that extra_data includes all templates (for later parsing if necessary)
        if (empty($this->_extra_data) || (empty($this->_extra_data['data']) && empty($this->_extra_data['template']))) {
            $this->_extra_data['data']     = $this->_data['data'];
            $this->_extra_data['template'] = $this->_data['template'];
        }

    }


    /**
     * This returns any attributes that may be existing on an EE_Shortcode
     *
     * @since 4.5.0
     * @param string $shortcode incoming shortcode
     * @return array An array with the attributes
     */
    protected function _get_shortcode_attrs($shortcode)
    {
        //make sure the required wp helper function is present
        //require the shortcode file if necessary
        if (! function_exists('shortcode_parse_atts')) {
            require_once(ABSPATH . WPINC . '/shortcodes.php');
        }

        //let's get any attributes that may be present and set the defaults.
        $shortcode_to_parse = str_replace('[', '', str_replace(']', '', $shortcode));
        return shortcode_parse_atts($shortcode_to_parse);
    }


    /**
     * Conditional blocks are shortcode patterns with an opening conditional tag `[IF_*]` and a corresponding
     * closing tag (eg `[/IF_*]`).  The content within the tags will be displayed/hidden depending on whatever conditions
     * existed in the opening tag.  This method handles parsing the actual template to show/hide this conditional content.
     *
     * @since 4.9.32
     *
     * @param string $shortcode  This should be original shortcode as used in the template and passed to the parser.
     * @param bool $show  true means the opening and closing tags are removed and the content is left showing, false
     *                    means the opening and closing tags and the contained content are removed.
     * @return string     The template for the shortcode is returned.
     */
    protected function _mutate_conditional_block_in_template($shortcode, $show = true)
    {
        //first let's get all the matches in the template for this particular shortcode.
        preg_match_all('~' . $this->_get_conditional_block_regex($shortcode) . '~', $this->_data['template'], $matches);

        if ($matches && is_array($matches[0]) && !empty($matches[0])) {

The expression $matches of type string[][] is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            //we need to hide all instances of the matches
            foreach ($matches[0] as $index => $content_to_show_or_hide) {
                $content_to_show_or_hide = preg_quote($content_to_show_or_hide);
                $replacement = $show ? $matches[4][$index] : '';
                $this->_data['template'] = preg_replace(
                    '~' . $content_to_show_or_hide . '~',
                    $replacement,
                    $this->_data['template']
                );
            }
        }
        //return $template
        return $this->_data['template'];
    }


    /**
     * This returns the regex pattern to use for conditional shortcodes parsing.
     *
     * Note: regex comes in part from the WP `get_shortcode_regex` expression in \wp-includes\shortcodes.php
     *
     * @param $shortcode
     * @since 4.9.32
     * @return string
     */
    private function _get_conditional_block_regex($shortcode)
    {
        //get just the shortcode tag for the match
        preg_match('@\[([^<>&/\[\]\x00-\x20=]++)@', $shortcode, $shortcode_tag_matches);
        if (empty($shortcode_tag_matches[1])) {
            return $this->_data['template'];
        }

        $shortcode_tag = $shortcode_tag_matches[1];
        //get attributes_part_of_tag
        $attributes_part = preg_quote(str_replace(array($shortcode_tag,'[',']'), '', $shortcode));
        //escape
        $shortcode_tag = preg_quote($shortcode_tag);

        return
              '\['                                  //Opening Bracket
            . "($shortcode_tag)$attributes_part"    //1: Shortcode Name
            . '(?![\w-])'                           //Not followed by word character or hyphen
            . '('                                   //2: Unroll the loop: Inside the opening shortcode tag
            .   '[^\]\/]*'                          //Not a closing bracket or forward slash
            .   '(?:'
            .       '\/(?!\])'                      //A forward slash not followed by a closing bracket
            .       '[^\]\/]*'                      //Not a closing bracket or forward slash.
            .   ')*?'
            . ')'
            . '(?:'
            .   '(\/)'                              //3. Self closing tag ...
            .   '\]'                                // ... and closing bracket
            . '|'
            .   '\]'                                //Closing bracket
            .   '(?:'
            .       '('                             //4: Unroll the loop: Optionally, anything between the opening and closing brackets
            .           '[^\[]*+'                   //Not an opening bracket
            .           '(?:'
            .               '\[(?!\/\1\])'          //An opening bracket not followed by the closing shortcode tag.
            .               '[^\[]*+'               //Not an opening bracket
            .           ')*+'
            .       ')'
            .       '\[\/\1\]'                      //Closing shortcode tag
            .   ')?'
            . ')';
    }


    /**
     * This sets the properties related to the messages system
     *
     * @since 4.5.0
     * @return void
     */
    protected function _set_messages_properties()
    {
        //should be in _extra_data
        if (isset($this->_extra_data['messenger'])) {
            $this->_messenger    = $this->_extra_data['messenger'];
            $this->_message_type = $this->_extra_data['message_type'];
            $this->_context      = $this->_extra_data['message'] instanceof EE_Message ? $this->_extra_data['message']->context() : '';
            $this->_GRP_ID       = $this->_extra_data['message'] instanceof EE_Message ? $this->_extra_data['message']->GRP_ID() : 0;
            $this->_message      = $this->_extra_data['message'] instanceof EE_Message ? $this->_extra_data['message'] : null;
        }
    }


    /**
     * This returns whatever the set message type object is that was set on this shortcode parser.
     *
     * @since 4.5.0
     * @return EE_message_type
     */
    public function get_set_message_type()
    {
        return $this->_message_type;
    }


    /**
     * This returns whatever the set messenger object is that was set on this shortcode parser
     *
     * @since 4.5.0
     * @return EE_messenger
     */
    public function get_set_messenger()
    {
        return $this->_messenger;
    }


    /**
     * This returns whatever the set context string is on this shortcode parser.
     *
     * @since 4.5.0
     * @return string
     */
    public function get_set_context()
    {
        return $this->_context;
    }


    /**
     * This returns whatever the set EE_Message object is on this shortcode.
     *
     * @since 4.9.0
     * @return EE_Message
     */
    public function get_set_message()
    {
        return $this->_message;
    }


} //end EE_Shortcodes