@@ -19,94 +19,94 @@ |
||
| 19 | 19 | class ExitModal |
| 20 | 20 | { |
| 21 | 21 | |
| 22 | - /** |
|
| 23 | - * @var Registry |
|
| 24 | - */ |
|
| 25 | - private $assets_registry; |
|
| 22 | + /** |
|
| 23 | + * @var Registry |
|
| 24 | + */ |
|
| 25 | + private $assets_registry; |
|
| 26 | 26 | |
| 27 | - /** |
|
| 28 | - * ExitModal constructor. |
|
| 29 | - * |
|
| 30 | - * @param Registry $assets_registry |
|
| 31 | - */ |
|
| 32 | - public function __construct(Registry $assets_registry) |
|
| 33 | - { |
|
| 34 | - $this->assets_registry = $assets_registry; |
|
| 35 | - add_action('in_admin_footer', array($this, 'modalContainer')); |
|
| 36 | - add_action('admin_enqueue_scripts', array($this, 'enqueues')); |
|
| 37 | - } |
|
| 27 | + /** |
|
| 28 | + * ExitModal constructor. |
|
| 29 | + * |
|
| 30 | + * @param Registry $assets_registry |
|
| 31 | + */ |
|
| 32 | + public function __construct(Registry $assets_registry) |
|
| 33 | + { |
|
| 34 | + $this->assets_registry = $assets_registry; |
|
| 35 | + add_action('in_admin_footer', array($this, 'modalContainer')); |
|
| 36 | + add_action('admin_enqueue_scripts', array($this, 'enqueues')); |
|
| 37 | + } |
|
| 38 | 38 | |
| 39 | 39 | |
| 40 | - /** |
|
| 41 | - * Callback on in_admin_footer that is used to output the exit modal container. |
|
| 42 | - */ |
|
| 43 | - public function modalContainer() |
|
| 44 | - { |
|
| 45 | - echo '<div id="ee-exit-survey-modal"></div>'; |
|
| 46 | - } |
|
| 40 | + /** |
|
| 41 | + * Callback on in_admin_footer that is used to output the exit modal container. |
|
| 42 | + */ |
|
| 43 | + public function modalContainer() |
|
| 44 | + { |
|
| 45 | + echo '<div id="ee-exit-survey-modal"></div>'; |
|
| 46 | + } |
|
| 47 | 47 | |
| 48 | 48 | |
| 49 | - /** |
|
| 50 | - * Callback for `admin_enqueue_scripts` to take care of enqueueing scripts and styles specific to the modal. |
|
| 51 | - * |
|
| 52 | - * @throws InvalidArgumentException |
|
| 53 | - */ |
|
| 54 | - public function enqueues() |
|
| 55 | - { |
|
| 56 | - $current_user = new WP_User(get_current_user_id()); |
|
| 57 | - $this->assets_registry->addData( |
|
| 58 | - 'exitModali18n', |
|
| 59 | - array( |
|
| 60 | - 'introText' => htmlspecialchars( |
|
| 61 | - __( |
|
| 62 | - 'Do you have a moment to share why you are deactivating Event Espresso?', |
|
| 63 | - 'event_espresso' |
|
| 64 | - ), |
|
| 65 | - ENT_NOQUOTES |
|
| 66 | - ), |
|
| 67 | - 'doSurveyButtonText' => htmlspecialchars( |
|
| 68 | - __( |
|
| 69 | - 'Sure I\'ll help', |
|
| 70 | - 'event_espresso' |
|
| 71 | - ), |
|
| 72 | - ENT_NOQUOTES |
|
| 73 | - ), |
|
| 74 | - 'skipButtonText' => htmlspecialchars( |
|
| 75 | - __( |
|
| 76 | - 'Skip', |
|
| 77 | - 'event_espresso' |
|
| 78 | - ), |
|
| 79 | - ENT_NOQUOTES |
|
| 80 | - ) |
|
| 81 | - ) |
|
| 82 | - ); |
|
| 83 | - $this->assets_registry->addData( |
|
| 84 | - 'exitModalInfo', |
|
| 85 | - array( |
|
| 86 | - 'firstname' => htmlspecialchars($current_user->user_firstname), |
|
| 87 | - 'emailaddress' => htmlspecialchars($current_user->user_email), |
|
| 88 | - 'website' => htmlspecialchars(site_url()), |
|
| 89 | - 'isModalActive' => $this->isModalActive() |
|
| 90 | - ) |
|
| 91 | - ); |
|
| 49 | + /** |
|
| 50 | + * Callback for `admin_enqueue_scripts` to take care of enqueueing scripts and styles specific to the modal. |
|
| 51 | + * |
|
| 52 | + * @throws InvalidArgumentException |
|
| 53 | + */ |
|
| 54 | + public function enqueues() |
|
| 55 | + { |
|
| 56 | + $current_user = new WP_User(get_current_user_id()); |
|
| 57 | + $this->assets_registry->addData( |
|
| 58 | + 'exitModali18n', |
|
| 59 | + array( |
|
| 60 | + 'introText' => htmlspecialchars( |
|
| 61 | + __( |
|
| 62 | + 'Do you have a moment to share why you are deactivating Event Espresso?', |
|
| 63 | + 'event_espresso' |
|
| 64 | + ), |
|
| 65 | + ENT_NOQUOTES |
|
| 66 | + ), |
|
| 67 | + 'doSurveyButtonText' => htmlspecialchars( |
|
| 68 | + __( |
|
| 69 | + 'Sure I\'ll help', |
|
| 70 | + 'event_espresso' |
|
| 71 | + ), |
|
| 72 | + ENT_NOQUOTES |
|
| 73 | + ), |
|
| 74 | + 'skipButtonText' => htmlspecialchars( |
|
| 75 | + __( |
|
| 76 | + 'Skip', |
|
| 77 | + 'event_espresso' |
|
| 78 | + ), |
|
| 79 | + ENT_NOQUOTES |
|
| 80 | + ) |
|
| 81 | + ) |
|
| 82 | + ); |
|
| 83 | + $this->assets_registry->addData( |
|
| 84 | + 'exitModalInfo', |
|
| 85 | + array( |
|
| 86 | + 'firstname' => htmlspecialchars($current_user->user_firstname), |
|
| 87 | + 'emailaddress' => htmlspecialchars($current_user->user_email), |
|
| 88 | + 'website' => htmlspecialchars(site_url()), |
|
| 89 | + 'isModalActive' => $this->isModalActive() |
|
| 90 | + ) |
|
| 91 | + ); |
|
| 92 | 92 | |
| 93 | - wp_enqueue_script('ee-wp-plugins-page'); |
|
| 94 | - wp_enqueue_style('ee-wp-plugins-page'); |
|
| 95 | - } |
|
| 93 | + wp_enqueue_script('ee-wp-plugins-page'); |
|
| 94 | + wp_enqueue_style('ee-wp-plugins-page'); |
|
| 95 | + } |
|
| 96 | 96 | |
| 97 | 97 | |
| 98 | - /** |
|
| 99 | - * Exposes a filter switch for turning off the enqueueing of the modal script. |
|
| 100 | - * @return bool |
|
| 101 | - */ |
|
| 102 | - private function isModalActive() |
|
| 103 | - { |
|
| 104 | - return filter_var( |
|
| 105 | - apply_filters( |
|
| 106 | - 'FHEE__EventEspresso_core_domain_services_admin_ExitModal__isModalActive', |
|
| 107 | - true |
|
| 108 | - ), |
|
| 109 | - FILTER_VALIDATE_BOOLEAN |
|
| 110 | - ); |
|
| 111 | - } |
|
| 98 | + /** |
|
| 99 | + * Exposes a filter switch for turning off the enqueueing of the modal script. |
|
| 100 | + * @return bool |
|
| 101 | + */ |
|
| 102 | + private function isModalActive() |
|
| 103 | + { |
|
| 104 | + return filter_var( |
|
| 105 | + apply_filters( |
|
| 106 | + 'FHEE__EventEspresso_core_domain_services_admin_ExitModal__isModalActive', |
|
| 107 | + true |
|
| 108 | + ), |
|
| 109 | + FILTER_VALIDATE_BOOLEAN |
|
| 110 | + ); |
|
| 111 | + } |
|
| 112 | 112 | } |
@@ -73,7 +73,7 @@ discard block |
||
| 73 | 73 | public function fqcnMatchesObjectIdentifier($fqcn, $object_identifier) |
| 74 | 74 | { |
| 75 | 75 | return $fqcn === $object_identifier |
| 76 | - || strpos($object_identifier, $fqcn . ObjectIdentifier::DELIMITER) === 0; |
|
| 76 | + || strpos($object_identifier, $fqcn.ObjectIdentifier::DELIMITER) === 0; |
|
| 77 | 77 | } |
| 78 | 78 | |
| 79 | 79 | |
@@ -93,8 +93,8 @@ discard block |
||
| 93 | 93 | ) |
| 94 | 94 | ? $this->getIdentifierForArguments($arguments) |
| 95 | 95 | : ''; |
| 96 | - if (! empty($identifier)) { |
|
| 97 | - $fqcn .= ObjectIdentifier::DELIMITER . md5($identifier); |
|
| 96 | + if ( ! empty($identifier)) { |
|
| 97 | + $fqcn .= ObjectIdentifier::DELIMITER.md5($identifier); |
|
| 98 | 98 | } |
| 99 | 99 | return $fqcn; |
| 100 | 100 | } |
@@ -16,113 +16,113 @@ |
||
| 16 | 16 | class ObjectIdentifier |
| 17 | 17 | { |
| 18 | 18 | |
| 19 | - /** |
|
| 20 | - * used to separate the FQCN from the class's arguments identifier |
|
| 21 | - */ |
|
| 22 | - const DELIMITER = '____'; |
|
| 19 | + /** |
|
| 20 | + * used to separate the FQCN from the class's arguments identifier |
|
| 21 | + */ |
|
| 22 | + const DELIMITER = '____'; |
|
| 23 | 23 | |
| 24 | - /** |
|
| 25 | - * @var ClassInterfaceCache $class_cache |
|
| 26 | - */ |
|
| 27 | - private $class_cache; |
|
| 24 | + /** |
|
| 25 | + * @var ClassInterfaceCache $class_cache |
|
| 26 | + */ |
|
| 27 | + private $class_cache; |
|
| 28 | 28 | |
| 29 | 29 | |
| 30 | - /** |
|
| 31 | - * ObjectIdentifier constructor. |
|
| 32 | - * |
|
| 33 | - * @param ClassInterfaceCache $class_cache |
|
| 34 | - */ |
|
| 35 | - public function __construct(ClassInterfaceCache $class_cache) |
|
| 36 | - { |
|
| 37 | - $this->class_cache = $class_cache; |
|
| 38 | - } |
|
| 30 | + /** |
|
| 31 | + * ObjectIdentifier constructor. |
|
| 32 | + * |
|
| 33 | + * @param ClassInterfaceCache $class_cache |
|
| 34 | + */ |
|
| 35 | + public function __construct(ClassInterfaceCache $class_cache) |
|
| 36 | + { |
|
| 37 | + $this->class_cache = $class_cache; |
|
| 38 | + } |
|
| 39 | 39 | |
| 40 | 40 | |
| 41 | - /** |
|
| 42 | - * Returns true if the supplied $object_identifier contains |
|
| 43 | - * the delimiter used to separate an fqcn from the arguments hash |
|
| 44 | - * |
|
| 45 | - * @param string $object_identifier |
|
| 46 | - * @return bool |
|
| 47 | - */ |
|
| 48 | - public function hasArguments($object_identifier) |
|
| 49 | - { |
|
| 50 | - // type casting to bool instead of using strpos() !== false |
|
| 51 | - // because an object identifier should never begin with the delimiter |
|
| 52 | - // therefore the delimiter should NOT be found at position 0 |
|
| 53 | - return (bool) strpos($object_identifier, ObjectIdentifier::DELIMITER); |
|
| 54 | - } |
|
| 41 | + /** |
|
| 42 | + * Returns true if the supplied $object_identifier contains |
|
| 43 | + * the delimiter used to separate an fqcn from the arguments hash |
|
| 44 | + * |
|
| 45 | + * @param string $object_identifier |
|
| 46 | + * @return bool |
|
| 47 | + */ |
|
| 48 | + public function hasArguments($object_identifier) |
|
| 49 | + { |
|
| 50 | + // type casting to bool instead of using strpos() !== false |
|
| 51 | + // because an object identifier should never begin with the delimiter |
|
| 52 | + // therefore the delimiter should NOT be found at position 0 |
|
| 53 | + return (bool) strpos($object_identifier, ObjectIdentifier::DELIMITER); |
|
| 54 | + } |
|
| 55 | 55 | |
| 56 | 56 | |
| 57 | - /** |
|
| 58 | - * Returns true if the supplied FQCN equals the supplied $object_identifier |
|
| 59 | - * OR the supplied FQCN matches the FQCN portion of the supplied $object_identifier |
|
| 60 | - * AND that $object_identifier is for an object with arguments. |
|
| 61 | - * This allows a request for an object using a FQCN to match |
|
| 62 | - * a previously instantiated object with arguments |
|
| 63 | - * without having to know those arguments. |
|
| 64 | - * |
|
| 65 | - * @param string $fqcn |
|
| 66 | - * @param string $object_identifier |
|
| 67 | - * @return bool |
|
| 68 | - */ |
|
| 69 | - public function fqcnMatchesObjectIdentifier($fqcn, $object_identifier) |
|
| 70 | - { |
|
| 71 | - return $fqcn === $object_identifier |
|
| 72 | - || strpos($object_identifier, $fqcn . ObjectIdentifier::DELIMITER) === 0; |
|
| 73 | - } |
|
| 57 | + /** |
|
| 58 | + * Returns true if the supplied FQCN equals the supplied $object_identifier |
|
| 59 | + * OR the supplied FQCN matches the FQCN portion of the supplied $object_identifier |
|
| 60 | + * AND that $object_identifier is for an object with arguments. |
|
| 61 | + * This allows a request for an object using a FQCN to match |
|
| 62 | + * a previously instantiated object with arguments |
|
| 63 | + * without having to know those arguments. |
|
| 64 | + * |
|
| 65 | + * @param string $fqcn |
|
| 66 | + * @param string $object_identifier |
|
| 67 | + * @return bool |
|
| 68 | + */ |
|
| 69 | + public function fqcnMatchesObjectIdentifier($fqcn, $object_identifier) |
|
| 70 | + { |
|
| 71 | + return $fqcn === $object_identifier |
|
| 72 | + || strpos($object_identifier, $fqcn . ObjectIdentifier::DELIMITER) === 0; |
|
| 73 | + } |
|
| 74 | 74 | |
| 75 | 75 | |
| 76 | - /** |
|
| 77 | - * build a string representation of an object's FQCN and arguments |
|
| 78 | - * |
|
| 79 | - * @param string $fqcn |
|
| 80 | - * @param array $arguments |
|
| 81 | - * @return string |
|
| 82 | - */ |
|
| 83 | - public function getIdentifier($fqcn, array $arguments = array()) |
|
| 84 | - { |
|
| 85 | - // only build identifier from arguments if class is not ReservedInstanceInterface |
|
| 86 | - $identifier = ! $this->class_cache->hasInterface( |
|
| 87 | - $fqcn, |
|
| 88 | - 'EventEspresso\core\interfaces\ReservedInstanceInterface' |
|
| 89 | - ) |
|
| 90 | - ? $this->getIdentifierForArguments($arguments) |
|
| 91 | - : ''; |
|
| 92 | - if (! empty($identifier)) { |
|
| 93 | - $fqcn .= ObjectIdentifier::DELIMITER . md5($identifier); |
|
| 94 | - } |
|
| 95 | - return $fqcn; |
|
| 96 | - } |
|
| 76 | + /** |
|
| 77 | + * build a string representation of an object's FQCN and arguments |
|
| 78 | + * |
|
| 79 | + * @param string $fqcn |
|
| 80 | + * @param array $arguments |
|
| 81 | + * @return string |
|
| 82 | + */ |
|
| 83 | + public function getIdentifier($fqcn, array $arguments = array()) |
|
| 84 | + { |
|
| 85 | + // only build identifier from arguments if class is not ReservedInstanceInterface |
|
| 86 | + $identifier = ! $this->class_cache->hasInterface( |
|
| 87 | + $fqcn, |
|
| 88 | + 'EventEspresso\core\interfaces\ReservedInstanceInterface' |
|
| 89 | + ) |
|
| 90 | + ? $this->getIdentifierForArguments($arguments) |
|
| 91 | + : ''; |
|
| 92 | + if (! empty($identifier)) { |
|
| 93 | + $fqcn .= ObjectIdentifier::DELIMITER . md5($identifier); |
|
| 94 | + } |
|
| 95 | + return $fqcn; |
|
| 96 | + } |
|
| 97 | 97 | |
| 98 | 98 | |
| 99 | - /** |
|
| 100 | - * build a string representation of a object's arguments |
|
| 101 | - * (mostly because Closures can't be serialized) |
|
| 102 | - * |
|
| 103 | - * @param array $arguments |
|
| 104 | - * @return string |
|
| 105 | - */ |
|
| 106 | - protected function getIdentifierForArguments(array $arguments) |
|
| 107 | - { |
|
| 108 | - if (empty($arguments)) { |
|
| 109 | - return ''; |
|
| 110 | - } |
|
| 111 | - $identifier = ''; |
|
| 112 | - foreach ($arguments as $argument) { |
|
| 113 | - switch (true) { |
|
| 114 | - case is_object($argument): |
|
| 115 | - case $argument instanceof Closure: |
|
| 116 | - $identifier .= spl_object_hash($argument); |
|
| 117 | - break; |
|
| 118 | - case is_array($argument): |
|
| 119 | - $identifier .= $this->getIdentifierForArguments($argument); |
|
| 120 | - break; |
|
| 121 | - default: |
|
| 122 | - $identifier .= $argument; |
|
| 123 | - break; |
|
| 124 | - } |
|
| 125 | - } |
|
| 126 | - return $identifier; |
|
| 127 | - } |
|
| 99 | + /** |
|
| 100 | + * build a string representation of a object's arguments |
|
| 101 | + * (mostly because Closures can't be serialized) |
|
| 102 | + * |
|
| 103 | + * @param array $arguments |
|
| 104 | + * @return string |
|
| 105 | + */ |
|
| 106 | + protected function getIdentifierForArguments(array $arguments) |
|
| 107 | + { |
|
| 108 | + if (empty($arguments)) { |
|
| 109 | + return ''; |
|
| 110 | + } |
|
| 111 | + $identifier = ''; |
|
| 112 | + foreach ($arguments as $argument) { |
|
| 113 | + switch (true) { |
|
| 114 | + case is_object($argument): |
|
| 115 | + case $argument instanceof Closure: |
|
| 116 | + $identifier .= spl_object_hash($argument); |
|
| 117 | + break; |
|
| 118 | + case is_array($argument): |
|
| 119 | + $identifier .= $this->getIdentifierForArguments($argument); |
|
| 120 | + break; |
|
| 121 | + default: |
|
| 122 | + $identifier .= $argument; |
|
| 123 | + break; |
|
| 124 | + } |
|
| 125 | + } |
|
| 126 | + return $identifier; |
|
| 127 | + } |
|
| 128 | 128 | } |
@@ -16,55 +16,55 @@ |
||
| 16 | 16 | interface DomainInterface extends InterminableInterface |
| 17 | 17 | { |
| 18 | 18 | |
| 19 | - /** |
|
| 20 | - * @return string |
|
| 21 | - * @throws DomainException |
|
| 22 | - */ |
|
| 23 | - public function pluginFile(); |
|
| 19 | + /** |
|
| 20 | + * @return string |
|
| 21 | + * @throws DomainException |
|
| 22 | + */ |
|
| 23 | + public function pluginFile(); |
|
| 24 | 24 | |
| 25 | 25 | |
| 26 | - /** |
|
| 27 | - * @return string |
|
| 28 | - * @throws DomainException |
|
| 29 | - */ |
|
| 30 | - public function pluginBasename(); |
|
| 26 | + /** |
|
| 27 | + * @return string |
|
| 28 | + * @throws DomainException |
|
| 29 | + */ |
|
| 30 | + public function pluginBasename(); |
|
| 31 | 31 | |
| 32 | 32 | |
| 33 | - /** |
|
| 34 | - * @return string |
|
| 35 | - */ |
|
| 36 | - public function pluginPath(); |
|
| 33 | + /** |
|
| 34 | + * @return string |
|
| 35 | + */ |
|
| 36 | + public function pluginPath(); |
|
| 37 | 37 | |
| 38 | 38 | |
| 39 | - /** |
|
| 40 | - * @return string |
|
| 41 | - * @throws DomainException |
|
| 42 | - */ |
|
| 43 | - public function pluginUrl(); |
|
| 39 | + /** |
|
| 40 | + * @return string |
|
| 41 | + * @throws DomainException |
|
| 42 | + */ |
|
| 43 | + public function pluginUrl(); |
|
| 44 | 44 | |
| 45 | 45 | |
| 46 | - /** |
|
| 47 | - * @return string |
|
| 48 | - * @throws DomainException |
|
| 49 | - */ |
|
| 50 | - public function version(); |
|
| 46 | + /** |
|
| 47 | + * @return string |
|
| 48 | + * @throws DomainException |
|
| 49 | + */ |
|
| 50 | + public function version(); |
|
| 51 | 51 | |
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * @return string |
|
| 55 | - */ |
|
| 56 | - public function distributionAssetsPath(); |
|
| 53 | + /** |
|
| 54 | + * @return string |
|
| 55 | + */ |
|
| 56 | + public function distributionAssetsPath(); |
|
| 57 | 57 | |
| 58 | 58 | |
| 59 | - /** |
|
| 60 | - * @return string |
|
| 61 | - */ |
|
| 62 | - public function distributionAssetsUrl(); |
|
| 59 | + /** |
|
| 60 | + * @return string |
|
| 61 | + */ |
|
| 62 | + public function distributionAssetsUrl(); |
|
| 63 | 63 | |
| 64 | 64 | |
| 65 | - /** |
|
| 66 | - * @return string |
|
| 67 | - */ |
|
| 68 | - public function assetNamespace(); |
|
| 65 | + /** |
|
| 66 | + * @return string |
|
| 67 | + */ |
|
| 68 | + public function assetNamespace(); |
|
| 69 | 69 | |
| 70 | 70 | } |
@@ -20,55 +20,55 @@ |
||
| 20 | 20 | class BlockCollection extends Collection |
| 21 | 21 | { |
| 22 | 22 | |
| 23 | - /** |
|
| 24 | - * Collection constructor |
|
| 25 | - * |
|
| 26 | - * @throws InvalidInterfaceException |
|
| 27 | - */ |
|
| 28 | - public function __construct() |
|
| 29 | - { |
|
| 30 | - parent::__construct('EventEspresso\core\domain\entities\editor\BlockInterface'); |
|
| 31 | - } |
|
| 23 | + /** |
|
| 24 | + * Collection constructor |
|
| 25 | + * |
|
| 26 | + * @throws InvalidInterfaceException |
|
| 27 | + */ |
|
| 28 | + public function __construct() |
|
| 29 | + { |
|
| 30 | + parent::__construct('EventEspresso\core\domain\entities\editor\BlockInterface'); |
|
| 31 | + } |
|
| 32 | 32 | |
| 33 | 33 | |
| 34 | - /** |
|
| 35 | - * unRegisterBlock |
|
| 36 | - * finds block in the Collection based on the identifier that was set using addObject() |
|
| 37 | - * and calls unRegisterBlock() on it. Returns block if successful and false if block was not found. |
|
| 38 | - * PLZ NOTE: the pointer is reset to the beginning of the collection afterwards |
|
| 39 | - * |
|
| 40 | - * @param mixed $identifier |
|
| 41 | - * @return boolean |
|
| 42 | - */ |
|
| 43 | - public function unRegisterBlock($identifier) |
|
| 44 | - { |
|
| 45 | - $this->rewind(); |
|
| 46 | - while ($this->valid()) { |
|
| 47 | - if ($identifier === $this->getInfo()) { |
|
| 48 | - $object = $this->current(); |
|
| 49 | - $this->rewind(); |
|
| 50 | - return $object->unRegisterBlock(); |
|
| 51 | - } |
|
| 52 | - $this->next(); |
|
| 53 | - } |
|
| 54 | - return false; |
|
| 55 | - } |
|
| 34 | + /** |
|
| 35 | + * unRegisterBlock |
|
| 36 | + * finds block in the Collection based on the identifier that was set using addObject() |
|
| 37 | + * and calls unRegisterBlock() on it. Returns block if successful and false if block was not found. |
|
| 38 | + * PLZ NOTE: the pointer is reset to the beginning of the collection afterwards |
|
| 39 | + * |
|
| 40 | + * @param mixed $identifier |
|
| 41 | + * @return boolean |
|
| 42 | + */ |
|
| 43 | + public function unRegisterBlock($identifier) |
|
| 44 | + { |
|
| 45 | + $this->rewind(); |
|
| 46 | + while ($this->valid()) { |
|
| 47 | + if ($identifier === $this->getInfo()) { |
|
| 48 | + $object = $this->current(); |
|
| 49 | + $this->rewind(); |
|
| 50 | + return $object->unRegisterBlock(); |
|
| 51 | + } |
|
| 52 | + $this->next(); |
|
| 53 | + } |
|
| 54 | + return false; |
|
| 55 | + } |
|
| 56 | 56 | |
| 57 | 57 | |
| 58 | - /** |
|
| 59 | - * unRegisterAllBlocks |
|
| 60 | - * calls unRegisterBlock() on all blocks in Collection. |
|
| 61 | - * PLZ NOTE: the pointer is reset to the beginning of the collection afterwards |
|
| 62 | - * |
|
| 63 | - * @return void |
|
| 64 | - */ |
|
| 65 | - public function unRegisterAllBlocks() |
|
| 66 | - { |
|
| 67 | - $this->rewind(); |
|
| 68 | - while ($this->valid()) { |
|
| 69 | - $this->current()->unRegisterBlock(); |
|
| 70 | - $this->next(); |
|
| 71 | - } |
|
| 72 | - $this->rewind(); |
|
| 73 | - } |
|
| 58 | + /** |
|
| 59 | + * unRegisterAllBlocks |
|
| 60 | + * calls unRegisterBlock() on all blocks in Collection. |
|
| 61 | + * PLZ NOTE: the pointer is reset to the beginning of the collection afterwards |
|
| 62 | + * |
|
| 63 | + * @return void |
|
| 64 | + */ |
|
| 65 | + public function unRegisterAllBlocks() |
|
| 66 | + { |
|
| 67 | + $this->rewind(); |
|
| 68 | + while ($this->valid()) { |
|
| 69 | + $this->current()->unRegisterBlock(); |
|
| 70 | + $this->next(); |
|
| 71 | + } |
|
| 72 | + $this->rewind(); |
|
| 73 | + } |
|
| 74 | 74 | } |
@@ -375,11 +375,11 @@ discard block |
||
| 375 | 375 | |
| 376 | 376 | |
| 377 | 377 | /** |
| 378 | - * @param mixed $var |
|
| 378 | + * @param string $var |
|
| 379 | 379 | * @param string $var_name |
| 380 | 380 | * @param string $file |
| 381 | 381 | * @param int|string $line |
| 382 | - * @param int|string $heading_tag |
|
| 382 | + * @param integer $heading_tag |
|
| 383 | 383 | * @param bool $die |
| 384 | 384 | * @param string $margin |
| 385 | 385 | */ |
@@ -411,6 +411,9 @@ discard block |
||
| 411 | 411 | } |
| 412 | 412 | |
| 413 | 413 | |
| 414 | + /** |
|
| 415 | + * @param integer $heading_tag |
|
| 416 | + */ |
|
| 414 | 417 | protected static function headingTag($heading_tag) |
| 415 | 418 | { |
| 416 | 419 | $heading_tag = absint($heading_tag); |
@@ -532,8 +535,8 @@ discard block |
||
| 532 | 535 | * @param mixed $var |
| 533 | 536 | * @param string $var_name |
| 534 | 537 | * @param string $file |
| 535 | - * @param int|string $line |
|
| 536 | - * @param int|string $heading_tag |
|
| 538 | + * @param integer $line |
|
| 539 | + * @param integer $heading_tag |
|
| 537 | 540 | * @param bool $die |
| 538 | 541 | */ |
| 539 | 542 | public static function printr( |
@@ -596,7 +599,7 @@ discard block |
||
| 596 | 599 | |
| 597 | 600 | /** |
| 598 | 601 | * @deprecated 4.9.39.rc.034 |
| 599 | - * @param null $timer_name |
|
| 602 | + * @param string $timer_name |
|
| 600 | 603 | */ |
| 601 | 604 | public function start_timer($timer_name = null) |
| 602 | 605 | { |
@@ -34,7 +34,7 @@ discard block |
||
| 34 | 34 | public static function instance() |
| 35 | 35 | { |
| 36 | 36 | // check if class object is instantiated, and instantiated properly |
| 37 | - if (! self::$_instance instanceof EEH_Debug_Tools) { |
|
| 37 | + if ( ! self::$_instance instanceof EEH_Debug_Tools) { |
|
| 38 | 38 | self::$_instance = new self(); |
| 39 | 39 | } |
| 40 | 40 | return self::$_instance; |
@@ -48,13 +48,13 @@ discard block |
||
| 48 | 48 | private function __construct() |
| 49 | 49 | { |
| 50 | 50 | // load Kint PHP debugging library |
| 51 | - if (! class_exists('Kint') && file_exists(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php')) { |
|
| 51 | + if ( ! class_exists('Kint') && file_exists(EE_PLUGIN_DIR_PATH.'tests/kint/Kint.class.php')) { |
|
| 52 | 52 | // despite EE4 having a check for an existing copy of the Kint debugging class, |
| 53 | 53 | // if another plugin was loaded AFTER EE4 and they did NOT perform a similar check, |
| 54 | 54 | // then hilarity would ensue as PHP throws a "Cannot redeclare class Kint" error |
| 55 | 55 | // so we've moved it to our test folder so that it is not included with production releases |
| 56 | 56 | // plz use https://wordpress.org/plugins/kint-debugger/ if testing production versions of EE |
| 57 | - require_once(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php'); |
|
| 57 | + require_once(EE_PLUGIN_DIR_PATH.'tests/kint/Kint.class.php'); |
|
| 58 | 58 | } |
| 59 | 59 | // if ( ! defined('DOING_AJAX') || $_REQUEST['noheader'] !== 'true' || ! isset( $_REQUEST['noheader'], $_REQUEST['TB_iframe'] ) ) { |
| 60 | 60 | // add_action( 'shutdown', array($this,'espresso_session_footer_dump') ); |
@@ -74,7 +74,7 @@ discard block |
||
| 74 | 74 | */ |
| 75 | 75 | public static function show_db_name() |
| 76 | 76 | { |
| 77 | - if (! defined('DOING_AJAX') && (defined('EE_ERROR_EMAILS') && EE_ERROR_EMAILS)) { |
|
| 77 | + if ( ! defined('DOING_AJAX') && (defined('EE_ERROR_EMAILS') && EE_ERROR_EMAILS)) { |
|
| 78 | 78 | echo '<p style="font-size:10px;font-weight:normal;color:#E76700;margin: 1em 2em; text-align: right;">DB_NAME: ' |
| 79 | 79 | . DB_NAME |
| 80 | 80 | . '</p>'; |
@@ -123,12 +123,12 @@ discard block |
||
| 123 | 123 | global $wp_filter; |
| 124 | 124 | echo '<br/><br/><br/><h3>Hooked Functions</h3>'; |
| 125 | 125 | if ($tag) { |
| 126 | - $hook[ $tag ] = $wp_filter[ $tag ]; |
|
| 127 | - if (! is_array($hook[ $tag ])) { |
|
| 126 | + $hook[$tag] = $wp_filter[$tag]; |
|
| 127 | + if ( ! is_array($hook[$tag])) { |
|
| 128 | 128 | trigger_error("Nothing found for '$tag' hook", E_USER_WARNING); |
| 129 | 129 | return; |
| 130 | 130 | } |
| 131 | - echo '<h5>For Tag: ' . $tag . '</h5>'; |
|
| 131 | + echo '<h5>For Tag: '.$tag.'</h5>'; |
|
| 132 | 132 | } else { |
| 133 | 133 | $hook = is_array($wp_filter) ? $wp_filter : array($wp_filter); |
| 134 | 134 | ksort($hook); |
@@ -157,12 +157,12 @@ discard block |
||
| 157 | 157 | { |
| 158 | 158 | $filters = array(); |
| 159 | 159 | global $wp_filter; |
| 160 | - if (isset($wp_filter[ $hook_name ])) { |
|
| 161 | - $filters[ $hook_name ] = array(); |
|
| 162 | - foreach ($wp_filter[ $hook_name ] as $priority => $callbacks) { |
|
| 163 | - $filters[ $hook_name ][ $priority ] = array(); |
|
| 160 | + if (isset($wp_filter[$hook_name])) { |
|
| 161 | + $filters[$hook_name] = array(); |
|
| 162 | + foreach ($wp_filter[$hook_name] as $priority => $callbacks) { |
|
| 163 | + $filters[$hook_name][$priority] = array(); |
|
| 164 | 164 | foreach ($callbacks as $callback) { |
| 165 | - $filters[ $hook_name ][ $priority ][] = $callback['function']; |
|
| 165 | + $filters[$hook_name][$priority][] = $callback['function']; |
|
| 166 | 166 | } |
| 167 | 167 | } |
| 168 | 168 | } |
@@ -181,17 +181,17 @@ discard block |
||
| 181 | 181 | { |
| 182 | 182 | if (WP_DEBUG) { |
| 183 | 183 | $activation_errors = ob_get_contents(); |
| 184 | - if (! empty($activation_errors)) { |
|
| 185 | - $activation_errors = date('Y-m-d H:i:s') . "\n" . $activation_errors; |
|
| 184 | + if ( ! empty($activation_errors)) { |
|
| 185 | + $activation_errors = date('Y-m-d H:i:s')."\n".$activation_errors; |
|
| 186 | 186 | } |
| 187 | - espresso_load_required('EEH_File', EE_HELPERS . 'EEH_File.helper.php'); |
|
| 187 | + espresso_load_required('EEH_File', EE_HELPERS.'EEH_File.helper.php'); |
|
| 188 | 188 | if (class_exists('EEH_File')) { |
| 189 | 189 | try { |
| 190 | 190 | EEH_File::ensure_file_exists_and_is_writable( |
| 191 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html' |
|
| 191 | + EVENT_ESPRESSO_UPLOAD_DIR.'logs/espresso_plugin_activation_errors.html' |
|
| 192 | 192 | ); |
| 193 | 193 | EEH_File::write_to_file( |
| 194 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 194 | + EVENT_ESPRESSO_UPLOAD_DIR.'logs/espresso_plugin_activation_errors.html', |
|
| 195 | 195 | $activation_errors |
| 196 | 196 | ); |
| 197 | 197 | } catch (EE_Error $e) { |
@@ -211,11 +211,11 @@ discard block |
||
| 211 | 211 | } else { |
| 212 | 212 | // old school attempt |
| 213 | 213 | file_put_contents( |
| 214 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 214 | + EVENT_ESPRESSO_UPLOAD_DIR.'logs/espresso_plugin_activation_errors.html', |
|
| 215 | 215 | $activation_errors |
| 216 | 216 | ); |
| 217 | 217 | } |
| 218 | - $activation_errors = get_option('ee_plugin_activation_errors', '') . $activation_errors; |
|
| 218 | + $activation_errors = get_option('ee_plugin_activation_errors', '').$activation_errors; |
|
| 219 | 219 | update_option('ee_plugin_activation_errors', $activation_errors); |
| 220 | 220 | } |
| 221 | 221 | } |
@@ -275,7 +275,7 @@ discard block |
||
| 275 | 275 | // don't trigger error if doing ajax, |
| 276 | 276 | // instead we'll add a transient EE_Error notice that in theory should show on the next request. |
| 277 | 277 | if (defined('DOING_AJAX') && DOING_AJAX) { |
| 278 | - $error_message .= ' ' . esc_html__( |
|
| 278 | + $error_message .= ' '.esc_html__( |
|
| 279 | 279 | 'This is a doing_it_wrong message that was triggered during an ajax request. The request params on this request were: ', |
| 280 | 280 | 'event_espresso' |
| 281 | 281 | ); |
@@ -319,19 +319,19 @@ discard block |
||
| 319 | 319 | $debug_key = 'EE_DEBUG_SPCO' |
| 320 | 320 | ) { |
| 321 | 321 | if (WP_DEBUG) { |
| 322 | - $debug_key = $debug_key . '_' . EE_Session::instance()->id(); |
|
| 322 | + $debug_key = $debug_key.'_'.EE_Session::instance()->id(); |
|
| 323 | 323 | $debug_data = get_option($debug_key, array()); |
| 324 | 324 | $default_data = array( |
| 325 | - $class => $func . '() : ' . $line, |
|
| 325 | + $class => $func.'() : '.$line, |
|
| 326 | 326 | 'REQ' => $display_request ? $_REQUEST : '', |
| 327 | 327 | ); |
| 328 | 328 | // don't serialize objects |
| 329 | 329 | $info = self::strip_objects($info); |
| 330 | 330 | $index = ! empty($debug_index) ? $debug_index : 0; |
| 331 | - if (! isset($debug_data[ $index ])) { |
|
| 332 | - $debug_data[ $index ] = array(); |
|
| 331 | + if ( ! isset($debug_data[$index])) { |
|
| 332 | + $debug_data[$index] = array(); |
|
| 333 | 333 | } |
| 334 | - $debug_data[ $index ][ microtime() ] = array_merge($default_data, $info); |
|
| 334 | + $debug_data[$index][microtime()] = array_merge($default_data, $info); |
|
| 335 | 335 | update_option($debug_key, $debug_data); |
| 336 | 336 | } |
| 337 | 337 | } |
@@ -348,20 +348,20 @@ discard block |
||
| 348 | 348 | { |
| 349 | 349 | foreach ($info as $key => $value) { |
| 350 | 350 | if (is_array($value)) { |
| 351 | - $info[ $key ] = self::strip_objects($value); |
|
| 351 | + $info[$key] = self::strip_objects($value); |
|
| 352 | 352 | } elseif (is_object($value)) { |
| 353 | 353 | $object_class = get_class($value); |
| 354 | - $info[ $object_class ] = array(); |
|
| 355 | - $info[ $object_class ]['ID'] = method_exists($value, 'ID') ? $value->ID() : spl_object_hash($value); |
|
| 354 | + $info[$object_class] = array(); |
|
| 355 | + $info[$object_class]['ID'] = method_exists($value, 'ID') ? $value->ID() : spl_object_hash($value); |
|
| 356 | 356 | if (method_exists($value, 'ID')) { |
| 357 | - $info[ $object_class ]['ID'] = $value->ID(); |
|
| 357 | + $info[$object_class]['ID'] = $value->ID(); |
|
| 358 | 358 | } |
| 359 | 359 | if (method_exists($value, 'status')) { |
| 360 | - $info[ $object_class ]['status'] = $value->status(); |
|
| 360 | + $info[$object_class]['status'] = $value->status(); |
|
| 361 | 361 | } elseif (method_exists($value, 'status_ID')) { |
| 362 | - $info[ $object_class ]['status'] = $value->status_ID(); |
|
| 362 | + $info[$object_class]['status'] = $value->status_ID(); |
|
| 363 | 363 | } |
| 364 | - unset($info[ $key ]); |
|
| 364 | + unset($info[$key]); |
|
| 365 | 365 | } |
| 366 | 366 | } |
| 367 | 367 | return (array) $info; |
@@ -395,8 +395,8 @@ discard block |
||
| 395 | 395 | $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
| 396 | 396 | $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
| 397 | 397 | $result .= $is_method |
| 398 | - ? EEH_Debug_Tools::grey_span('::') . EEH_Debug_Tools::orange_span($var . '()') |
|
| 399 | - : EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span($var); |
|
| 398 | + ? EEH_Debug_Tools::grey_span('::').EEH_Debug_Tools::orange_span($var.'()') |
|
| 399 | + : EEH_Debug_Tools::grey_span(' : ').EEH_Debug_Tools::orange_span($var); |
|
| 400 | 400 | $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
| 401 | 401 | $result .= EEH_Debug_Tools::headingX($heading_tag); |
| 402 | 402 | if ($die) { |
@@ -450,7 +450,7 @@ discard block |
||
| 450 | 450 | return $heading; |
| 451 | 451 | } |
| 452 | 452 | $margin = "25px 0 0 {$margin}"; |
| 453 | - return '<' . $heading_tag . ' style="color:#2EA2CC; margin:' . $margin . ';"><b>' . $var_name . '</b>'; |
|
| 453 | + return '<'.$heading_tag.' style="color:#2EA2CC; margin:'.$margin.';"><b>'.$var_name.'</b>'; |
|
| 454 | 454 | } |
| 455 | 455 | |
| 456 | 456 | |
@@ -464,7 +464,7 @@ discard block |
||
| 464 | 464 | if (EEH_Debug_Tools::plainOutput()) { |
| 465 | 465 | return ''; |
| 466 | 466 | } |
| 467 | - return '</' . $heading_tag . '>'; |
|
| 467 | + return '</'.$heading_tag.'>'; |
|
| 468 | 468 | } |
| 469 | 469 | |
| 470 | 470 | |
@@ -478,7 +478,7 @@ discard block |
||
| 478 | 478 | if (EEH_Debug_Tools::plainOutput()) { |
| 479 | 479 | return $content; |
| 480 | 480 | } |
| 481 | - return '<span style="color:#999">' . $content . '</span>'; |
|
| 481 | + return '<span style="color:#999">'.$content.'</span>'; |
|
| 482 | 482 | } |
| 483 | 483 | |
| 484 | 484 | |
@@ -518,7 +518,7 @@ discard block |
||
| 518 | 518 | if (EEH_Debug_Tools::plainOutput()) { |
| 519 | 519 | return $content; |
| 520 | 520 | } |
| 521 | - return '<span style="color:#E76700">' . $content . '</span>'; |
|
| 521 | + return '<span style="color:#E76700">'.$content.'</span>'; |
|
| 522 | 522 | } |
| 523 | 523 | |
| 524 | 524 | |
@@ -535,7 +535,7 @@ discard block |
||
| 535 | 535 | if (EEH_Debug_Tools::plainOutput()) { |
| 536 | 536 | return $var; |
| 537 | 537 | } |
| 538 | - return '<pre style="color:#999; padding:1em; background: #fff">' . $var . '</pre>'; |
|
| 538 | + return '<pre style="color:#999; padding:1em; background: #fff">'.$var.'</pre>'; |
|
| 539 | 539 | } |
| 540 | 540 | |
| 541 | 541 | |
@@ -579,7 +579,7 @@ discard block |
||
| 579 | 579 | $heading_tag = EEH_Debug_Tools::headingTag($heading_tag); |
| 580 | 580 | $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
| 581 | 581 | $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
| 582 | - $result .= EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span( |
|
| 582 | + $result .= EEH_Debug_Tools::grey_span(' : ').EEH_Debug_Tools::orange_span( |
|
| 583 | 583 | EEH_Debug_Tools::pre_span($var) |
| 584 | 584 | ); |
| 585 | 585 | $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
@@ -11,676 +11,676 @@ discard block |
||
| 11 | 11 | class EEH_Debug_Tools |
| 12 | 12 | { |
| 13 | 13 | |
| 14 | - /** |
|
| 15 | - * instance of the EEH_Autoloader object |
|
| 16 | - * |
|
| 17 | - * @var $_instance |
|
| 18 | - * @access private |
|
| 19 | - */ |
|
| 20 | - private static $_instance; |
|
| 21 | - |
|
| 22 | - /** |
|
| 23 | - * @var array |
|
| 24 | - */ |
|
| 25 | - protected $_memory_usage_points = array(); |
|
| 26 | - |
|
| 27 | - |
|
| 28 | - |
|
| 29 | - /** |
|
| 30 | - * @singleton method used to instantiate class object |
|
| 31 | - * @access public |
|
| 32 | - * @return EEH_Debug_Tools |
|
| 33 | - */ |
|
| 34 | - public static function instance() |
|
| 35 | - { |
|
| 36 | - // check if class object is instantiated, and instantiated properly |
|
| 37 | - if (! self::$_instance instanceof EEH_Debug_Tools) { |
|
| 38 | - self::$_instance = new self(); |
|
| 39 | - } |
|
| 40 | - return self::$_instance; |
|
| 41 | - } |
|
| 42 | - |
|
| 43 | - |
|
| 44 | - |
|
| 45 | - /** |
|
| 46 | - * private class constructor |
|
| 47 | - */ |
|
| 48 | - private function __construct() |
|
| 49 | - { |
|
| 50 | - // load Kint PHP debugging library |
|
| 51 | - if (! class_exists('Kint') && file_exists(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php')) { |
|
| 52 | - // despite EE4 having a check for an existing copy of the Kint debugging class, |
|
| 53 | - // if another plugin was loaded AFTER EE4 and they did NOT perform a similar check, |
|
| 54 | - // then hilarity would ensue as PHP throws a "Cannot redeclare class Kint" error |
|
| 55 | - // so we've moved it to our test folder so that it is not included with production releases |
|
| 56 | - // plz use https://wordpress.org/plugins/kint-debugger/ if testing production versions of EE |
|
| 57 | - require_once(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php'); |
|
| 58 | - } |
|
| 59 | - // if ( ! defined('DOING_AJAX') || $_REQUEST['noheader'] !== 'true' || ! isset( $_REQUEST['noheader'], $_REQUEST['TB_iframe'] ) ) { |
|
| 60 | - // add_action( 'shutdown', array($this,'espresso_session_footer_dump') ); |
|
| 61 | - // } |
|
| 62 | - $plugin = basename(EE_PLUGIN_DIR_PATH); |
|
| 63 | - add_action("activate_{$plugin}", array('EEH_Debug_Tools', 'ee_plugin_activation_errors')); |
|
| 64 | - add_action('activated_plugin', array('EEH_Debug_Tools', 'ee_plugin_activation_errors')); |
|
| 65 | - add_action('shutdown', array('EEH_Debug_Tools', 'show_db_name')); |
|
| 66 | - } |
|
| 67 | - |
|
| 68 | - |
|
| 69 | - |
|
| 70 | - /** |
|
| 71 | - * show_db_name |
|
| 72 | - * |
|
| 73 | - * @return void |
|
| 74 | - */ |
|
| 75 | - public static function show_db_name() |
|
| 76 | - { |
|
| 77 | - if (! defined('DOING_AJAX') && (defined('EE_ERROR_EMAILS') && EE_ERROR_EMAILS)) { |
|
| 78 | - echo '<p style="font-size:10px;font-weight:normal;color:#E76700;margin: 1em 2em; text-align: right;">DB_NAME: ' |
|
| 79 | - . DB_NAME |
|
| 80 | - . '</p>'; |
|
| 81 | - } |
|
| 82 | - if (EE_DEBUG) { |
|
| 83 | - Benchmark::displayResults(); |
|
| 84 | - } |
|
| 85 | - } |
|
| 86 | - |
|
| 87 | - |
|
| 88 | - |
|
| 89 | - /** |
|
| 90 | - * dump EE_Session object at bottom of page after everything else has happened |
|
| 91 | - * |
|
| 92 | - * @return void |
|
| 93 | - */ |
|
| 94 | - public function espresso_session_footer_dump() |
|
| 95 | - { |
|
| 96 | - if ((defined('WP_DEBUG') && WP_DEBUG) |
|
| 97 | - && ! defined('DOING_AJAX') |
|
| 98 | - && class_exists('Kint') |
|
| 99 | - && function_exists('wp_get_current_user') |
|
| 100 | - && current_user_can('update_core') |
|
| 101 | - && class_exists('EE_Registry') |
|
| 102 | - ) { |
|
| 103 | - Kint::dump(EE_Registry::instance()->SSN->id()); |
|
| 104 | - Kint::dump(EE_Registry::instance()->SSN); |
|
| 105 | - // Kint::dump( EE_Registry::instance()->SSN->get_session_data('cart')->get_tickets() ); |
|
| 106 | - $this->espresso_list_hooked_functions(); |
|
| 107 | - Benchmark::displayResults(); |
|
| 108 | - } |
|
| 109 | - } |
|
| 110 | - |
|
| 111 | - |
|
| 112 | - |
|
| 113 | - /** |
|
| 114 | - * List All Hooked Functions |
|
| 115 | - * to list all functions for a specific hook, add ee_list_hooks={hook-name} to URL |
|
| 116 | - * http://wp.smashingmagazine.com/2009/08/18/10-useful-wordpress-hook-hacks/ |
|
| 117 | - * |
|
| 118 | - * @param string $tag |
|
| 119 | - * @return void |
|
| 120 | - */ |
|
| 121 | - public function espresso_list_hooked_functions($tag = '') |
|
| 122 | - { |
|
| 123 | - global $wp_filter; |
|
| 124 | - echo '<br/><br/><br/><h3>Hooked Functions</h3>'; |
|
| 125 | - if ($tag) { |
|
| 126 | - $hook[ $tag ] = $wp_filter[ $tag ]; |
|
| 127 | - if (! is_array($hook[ $tag ])) { |
|
| 128 | - trigger_error("Nothing found for '$tag' hook", E_USER_WARNING); |
|
| 129 | - return; |
|
| 130 | - } |
|
| 131 | - echo '<h5>For Tag: ' . $tag . '</h5>'; |
|
| 132 | - } else { |
|
| 133 | - $hook = is_array($wp_filter) ? $wp_filter : array($wp_filter); |
|
| 134 | - ksort($hook); |
|
| 135 | - } |
|
| 136 | - foreach ($hook as $tag_name => $priorities) { |
|
| 137 | - echo "<br />>>>>>\t<strong>$tag_name</strong><br />"; |
|
| 138 | - ksort($priorities); |
|
| 139 | - foreach ($priorities as $priority => $function) { |
|
| 140 | - echo $priority; |
|
| 141 | - foreach ($function as $name => $properties) { |
|
| 142 | - echo "\t$name<br />"; |
|
| 143 | - } |
|
| 144 | - } |
|
| 145 | - } |
|
| 146 | - } |
|
| 147 | - |
|
| 148 | - |
|
| 149 | - |
|
| 150 | - /** |
|
| 151 | - * registered_filter_callbacks |
|
| 152 | - * |
|
| 153 | - * @param string $hook_name |
|
| 154 | - * @return array |
|
| 155 | - */ |
|
| 156 | - public static function registered_filter_callbacks($hook_name = '') |
|
| 157 | - { |
|
| 158 | - $filters = array(); |
|
| 159 | - global $wp_filter; |
|
| 160 | - if (isset($wp_filter[ $hook_name ])) { |
|
| 161 | - $filters[ $hook_name ] = array(); |
|
| 162 | - foreach ($wp_filter[ $hook_name ] as $priority => $callbacks) { |
|
| 163 | - $filters[ $hook_name ][ $priority ] = array(); |
|
| 164 | - foreach ($callbacks as $callback) { |
|
| 165 | - $filters[ $hook_name ][ $priority ][] = $callback['function']; |
|
| 166 | - } |
|
| 167 | - } |
|
| 168 | - } |
|
| 169 | - return $filters; |
|
| 170 | - } |
|
| 171 | - |
|
| 172 | - |
|
| 173 | - |
|
| 174 | - /** |
|
| 175 | - * captures plugin activation errors for debugging |
|
| 176 | - * |
|
| 177 | - * @return void |
|
| 178 | - * @throws EE_Error |
|
| 179 | - */ |
|
| 180 | - public static function ee_plugin_activation_errors() |
|
| 181 | - { |
|
| 182 | - if (WP_DEBUG) { |
|
| 183 | - $activation_errors = ob_get_contents(); |
|
| 184 | - if (! empty($activation_errors)) { |
|
| 185 | - $activation_errors = date('Y-m-d H:i:s') . "\n" . $activation_errors; |
|
| 186 | - } |
|
| 187 | - espresso_load_required('EEH_File', EE_HELPERS . 'EEH_File.helper.php'); |
|
| 188 | - if (class_exists('EEH_File')) { |
|
| 189 | - try { |
|
| 190 | - EEH_File::ensure_file_exists_and_is_writable( |
|
| 191 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html' |
|
| 192 | - ); |
|
| 193 | - EEH_File::write_to_file( |
|
| 194 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 195 | - $activation_errors |
|
| 196 | - ); |
|
| 197 | - } catch (EE_Error $e) { |
|
| 198 | - EE_Error::add_error( |
|
| 199 | - sprintf( |
|
| 200 | - __( |
|
| 201 | - 'The Event Espresso activation errors file could not be setup because: %s', |
|
| 202 | - 'event_espresso' |
|
| 203 | - ), |
|
| 204 | - $e->getMessage() |
|
| 205 | - ), |
|
| 206 | - __FILE__, |
|
| 207 | - __FUNCTION__, |
|
| 208 | - __LINE__ |
|
| 209 | - ); |
|
| 210 | - } |
|
| 211 | - } else { |
|
| 212 | - // old school attempt |
|
| 213 | - file_put_contents( |
|
| 214 | - EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 215 | - $activation_errors |
|
| 216 | - ); |
|
| 217 | - } |
|
| 218 | - $activation_errors = get_option('ee_plugin_activation_errors', '') . $activation_errors; |
|
| 219 | - update_option('ee_plugin_activation_errors', $activation_errors); |
|
| 220 | - } |
|
| 221 | - } |
|
| 222 | - |
|
| 223 | - |
|
| 224 | - |
|
| 225 | - /** |
|
| 226 | - * This basically mimics the WordPress _doing_it_wrong() function except adds our own messaging etc. |
|
| 227 | - * Very useful for providing helpful messages to developers when the method of doing something has been deprecated, |
|
| 228 | - * or we want to make sure they use something the right way. |
|
| 229 | - * |
|
| 230 | - * @access public |
|
| 231 | - * @param string $function The function that was called |
|
| 232 | - * @param string $message A message explaining what has been done incorrectly |
|
| 233 | - * @param string $version The version of Event Espresso where the error was added |
|
| 234 | - * @param string $applies_when a version string for when you want the doing_it_wrong notice to begin appearing |
|
| 235 | - * for a deprecated function. This allows deprecation to occur during one version, |
|
| 236 | - * but not have any notices appear until a later version. This allows developers |
|
| 237 | - * extra time to update their code before notices appear. |
|
| 238 | - * @param int $error_type |
|
| 239 | - * @uses trigger_error() |
|
| 240 | - */ |
|
| 241 | - public function doing_it_wrong( |
|
| 242 | - $function, |
|
| 243 | - $message, |
|
| 244 | - $version, |
|
| 245 | - $applies_when = '', |
|
| 246 | - $error_type = null |
|
| 247 | - ) { |
|
| 248 | - $applies_when = ! empty($applies_when) ? $applies_when : espresso_version(); |
|
| 249 | - $error_type = $error_type !== null ? $error_type : E_USER_NOTICE; |
|
| 250 | - // because we swapped the parameter order around for the last two params, |
|
| 251 | - // let's verify that some third party isn't still passing an error type value for the third param |
|
| 252 | - if (is_int($applies_when)) { |
|
| 253 | - $error_type = $applies_when; |
|
| 254 | - $applies_when = espresso_version(); |
|
| 255 | - } |
|
| 256 | - // if not displaying notices yet, then just leave |
|
| 257 | - if (version_compare(espresso_version(), $applies_when, '<')) { |
|
| 258 | - return; |
|
| 259 | - } |
|
| 260 | - do_action('AHEE__EEH_Debug_Tools__doing_it_wrong_run', $function, $message, $version); |
|
| 261 | - $version = $version === null |
|
| 262 | - ? '' |
|
| 263 | - : sprintf( |
|
| 264 | - __('(This message was added in version %s of Event Espresso)', 'event_espresso'), |
|
| 265 | - $version |
|
| 266 | - ); |
|
| 267 | - $error_message = sprintf( |
|
| 268 | - esc_html__('%1$s was called %2$sincorrectly%3$s. %4$s %5$s', 'event_espresso'), |
|
| 269 | - $function, |
|
| 270 | - '<strong>', |
|
| 271 | - '</strong>', |
|
| 272 | - $message, |
|
| 273 | - $version |
|
| 274 | - ); |
|
| 275 | - // don't trigger error if doing ajax, |
|
| 276 | - // instead we'll add a transient EE_Error notice that in theory should show on the next request. |
|
| 277 | - if (defined('DOING_AJAX') && DOING_AJAX) { |
|
| 278 | - $error_message .= ' ' . esc_html__( |
|
| 279 | - 'This is a doing_it_wrong message that was triggered during an ajax request. The request params on this request were: ', |
|
| 280 | - 'event_espresso' |
|
| 281 | - ); |
|
| 282 | - $error_message .= '<ul><li>'; |
|
| 283 | - $error_message .= implode('</li><li>', EE_Registry::instance()->REQ->params()); |
|
| 284 | - $error_message .= '</ul>'; |
|
| 285 | - EE_Error::add_error($error_message, 'debug::doing_it_wrong', $function, '42'); |
|
| 286 | - // now we set this on the transient so it shows up on the next request. |
|
| 287 | - EE_Error::get_notices(false, true); |
|
| 288 | - } else { |
|
| 289 | - trigger_error($error_message, $error_type); |
|
| 290 | - } |
|
| 291 | - } |
|
| 292 | - |
|
| 293 | - |
|
| 294 | - |
|
| 295 | - |
|
| 296 | - /** |
|
| 297 | - * Logger helpers |
|
| 298 | - */ |
|
| 299 | - /** |
|
| 300 | - * debug |
|
| 301 | - * |
|
| 302 | - * @param string $class |
|
| 303 | - * @param string $func |
|
| 304 | - * @param string $line |
|
| 305 | - * @param array $info |
|
| 306 | - * @param bool $display_request |
|
| 307 | - * @param string $debug_index |
|
| 308 | - * @param string $debug_key |
|
| 309 | - * @throws EE_Error |
|
| 310 | - * @throws \EventEspresso\core\exceptions\InvalidSessionDataException |
|
| 311 | - */ |
|
| 312 | - public static function log( |
|
| 313 | - $class = '', |
|
| 314 | - $func = '', |
|
| 315 | - $line = '', |
|
| 316 | - $info = array(), |
|
| 317 | - $display_request = false, |
|
| 318 | - $debug_index = '', |
|
| 319 | - $debug_key = 'EE_DEBUG_SPCO' |
|
| 320 | - ) { |
|
| 321 | - if (WP_DEBUG) { |
|
| 322 | - $debug_key = $debug_key . '_' . EE_Session::instance()->id(); |
|
| 323 | - $debug_data = get_option($debug_key, array()); |
|
| 324 | - $default_data = array( |
|
| 325 | - $class => $func . '() : ' . $line, |
|
| 326 | - 'REQ' => $display_request ? $_REQUEST : '', |
|
| 327 | - ); |
|
| 328 | - // don't serialize objects |
|
| 329 | - $info = self::strip_objects($info); |
|
| 330 | - $index = ! empty($debug_index) ? $debug_index : 0; |
|
| 331 | - if (! isset($debug_data[ $index ])) { |
|
| 332 | - $debug_data[ $index ] = array(); |
|
| 333 | - } |
|
| 334 | - $debug_data[ $index ][ microtime() ] = array_merge($default_data, $info); |
|
| 335 | - update_option($debug_key, $debug_data); |
|
| 336 | - } |
|
| 337 | - } |
|
| 338 | - |
|
| 339 | - |
|
| 340 | - |
|
| 341 | - /** |
|
| 342 | - * strip_objects |
|
| 343 | - * |
|
| 344 | - * @param array $info |
|
| 345 | - * @return array |
|
| 346 | - */ |
|
| 347 | - public static function strip_objects($info = array()) |
|
| 348 | - { |
|
| 349 | - foreach ($info as $key => $value) { |
|
| 350 | - if (is_array($value)) { |
|
| 351 | - $info[ $key ] = self::strip_objects($value); |
|
| 352 | - } elseif (is_object($value)) { |
|
| 353 | - $object_class = get_class($value); |
|
| 354 | - $info[ $object_class ] = array(); |
|
| 355 | - $info[ $object_class ]['ID'] = method_exists($value, 'ID') ? $value->ID() : spl_object_hash($value); |
|
| 356 | - if (method_exists($value, 'ID')) { |
|
| 357 | - $info[ $object_class ]['ID'] = $value->ID(); |
|
| 358 | - } |
|
| 359 | - if (method_exists($value, 'status')) { |
|
| 360 | - $info[ $object_class ]['status'] = $value->status(); |
|
| 361 | - } elseif (method_exists($value, 'status_ID')) { |
|
| 362 | - $info[ $object_class ]['status'] = $value->status_ID(); |
|
| 363 | - } |
|
| 364 | - unset($info[ $key ]); |
|
| 365 | - } |
|
| 366 | - } |
|
| 367 | - return (array) $info; |
|
| 368 | - } |
|
| 369 | - |
|
| 370 | - |
|
| 371 | - |
|
| 372 | - /** |
|
| 373 | - * @param mixed $var |
|
| 374 | - * @param string $var_name |
|
| 375 | - * @param string $file |
|
| 376 | - * @param int|string $line |
|
| 377 | - * @param int|string $heading_tag |
|
| 378 | - * @param bool $die |
|
| 379 | - * @param string $margin |
|
| 380 | - */ |
|
| 381 | - public static function printv( |
|
| 382 | - $var, |
|
| 383 | - $var_name = '', |
|
| 384 | - $file = '', |
|
| 385 | - $line = '', |
|
| 386 | - $heading_tag = 5, |
|
| 387 | - $die = false, |
|
| 388 | - $margin = '' |
|
| 389 | - ) { |
|
| 390 | - $var_name = ! $var_name ? 'string' : $var_name; |
|
| 391 | - $var_name = ucwords(str_replace('$', '', $var_name)); |
|
| 392 | - $is_method = method_exists($var_name, $var); |
|
| 393 | - $var_name = ucwords(str_replace('_', ' ', $var_name)); |
|
| 394 | - $heading_tag = EEH_Debug_Tools::headingTag($heading_tag); |
|
| 395 | - $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
|
| 396 | - $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
|
| 397 | - $result .= $is_method |
|
| 398 | - ? EEH_Debug_Tools::grey_span('::') . EEH_Debug_Tools::orange_span($var . '()') |
|
| 399 | - : EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span($var); |
|
| 400 | - $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
|
| 401 | - $result .= EEH_Debug_Tools::headingX($heading_tag); |
|
| 402 | - if ($die) { |
|
| 403 | - die($result); |
|
| 404 | - } |
|
| 405 | - echo $result; |
|
| 406 | - } |
|
| 407 | - |
|
| 408 | - |
|
| 409 | - protected static function headingTag($heading_tag) |
|
| 410 | - { |
|
| 411 | - $heading_tag = absint($heading_tag); |
|
| 412 | - return $heading_tag > 0 && $heading_tag < 7 ? "h{$heading_tag}" : 'h5'; |
|
| 413 | - } |
|
| 414 | - |
|
| 415 | - |
|
| 416 | - protected static function headingSpacer($heading_tag) |
|
| 417 | - { |
|
| 418 | - return EEH_Debug_Tools::plainOutput() && ($heading_tag === 'h1' || $heading_tag === 'h2') |
|
| 419 | - ? "\n" |
|
| 420 | - : ''; |
|
| 421 | - } |
|
| 422 | - |
|
| 423 | - |
|
| 424 | - protected static function plainOutput() |
|
| 425 | - { |
|
| 426 | - return defined('EE_TESTS_DIR') |
|
| 427 | - || (defined('DOING_AJAX') && DOING_AJAX) |
|
| 428 | - || ( |
|
| 429 | - isset($_SERVER['REQUEST_URI']) |
|
| 430 | - && strpos(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), 'wp-json') !== false |
|
| 431 | - ); |
|
| 432 | - } |
|
| 433 | - |
|
| 434 | - |
|
| 435 | - /** |
|
| 436 | - * @param string $var_name |
|
| 437 | - * @param string $heading_tag |
|
| 438 | - * @param string $margin |
|
| 439 | - * @param int $line |
|
| 440 | - * @return string |
|
| 441 | - */ |
|
| 442 | - protected static function heading($var_name = '', $heading_tag = 'h5', $margin = '', $line = 0) |
|
| 443 | - { |
|
| 444 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 445 | - $heading = ''; |
|
| 446 | - if ($heading_tag === 'h1' || $heading_tag === 'h2') { |
|
| 447 | - $heading .= "\n"; |
|
| 448 | - } |
|
| 449 | - $heading .= "\n{$line}) {$var_name}"; |
|
| 450 | - return $heading; |
|
| 451 | - } |
|
| 452 | - $margin = "25px 0 0 {$margin}"; |
|
| 453 | - return '<' . $heading_tag . ' style="color:#2EA2CC; margin:' . $margin . ';"><b>' . $var_name . '</b>'; |
|
| 454 | - } |
|
| 455 | - |
|
| 456 | - |
|
| 457 | - |
|
| 458 | - /** |
|
| 459 | - * @param string $heading_tag |
|
| 460 | - * @return string |
|
| 461 | - */ |
|
| 462 | - protected static function headingX($heading_tag = 'h5') |
|
| 463 | - { |
|
| 464 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 465 | - return ''; |
|
| 466 | - } |
|
| 467 | - return '</' . $heading_tag . '>'; |
|
| 468 | - } |
|
| 469 | - |
|
| 470 | - |
|
| 471 | - |
|
| 472 | - /** |
|
| 473 | - * @param string $content |
|
| 474 | - * @return string |
|
| 475 | - */ |
|
| 476 | - protected static function grey_span($content = '') |
|
| 477 | - { |
|
| 478 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 479 | - return $content; |
|
| 480 | - } |
|
| 481 | - return '<span style="color:#999">' . $content . '</span>'; |
|
| 482 | - } |
|
| 483 | - |
|
| 484 | - |
|
| 485 | - |
|
| 486 | - /** |
|
| 487 | - * @param string $file |
|
| 488 | - * @param int $line |
|
| 489 | - * @return string |
|
| 490 | - */ |
|
| 491 | - protected static function file_and_line($file, $line, $heading_tag) |
|
| 492 | - { |
|
| 493 | - if ($file === '' || $line === '') { |
|
| 494 | - return ''; |
|
| 495 | - } |
|
| 496 | - $file = str_replace(EE_PLUGIN_DIR_PATH, '/', $file); |
|
| 497 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 498 | - if ($heading_tag === 'h1' || $heading_tag === 'h2') { |
|
| 499 | - return " ({$file})"; |
|
| 500 | - } |
|
| 501 | - return ''; |
|
| 502 | - } |
|
| 503 | - return '<br /><span style="font-size:9px;font-weight:normal;color:#666;line-height: 12px;">' |
|
| 504 | - . $file |
|
| 505 | - . '<br />line no: ' |
|
| 506 | - . $line |
|
| 507 | - . '</span>'; |
|
| 508 | - } |
|
| 509 | - |
|
| 510 | - |
|
| 511 | - |
|
| 512 | - /** |
|
| 513 | - * @param string $content |
|
| 514 | - * @return string |
|
| 515 | - */ |
|
| 516 | - protected static function orange_span($content = '') |
|
| 517 | - { |
|
| 518 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 519 | - return $content; |
|
| 520 | - } |
|
| 521 | - return '<span style="color:#E76700">' . $content . '</span>'; |
|
| 522 | - } |
|
| 523 | - |
|
| 524 | - |
|
| 525 | - |
|
| 526 | - /** |
|
| 527 | - * @param mixed $var |
|
| 528 | - * @return string |
|
| 529 | - */ |
|
| 530 | - protected static function pre_span($var) |
|
| 531 | - { |
|
| 532 | - ob_start(); |
|
| 533 | - var_dump($var); |
|
| 534 | - $var = ob_get_clean(); |
|
| 535 | - if (EEH_Debug_Tools::plainOutput()) { |
|
| 536 | - return $var; |
|
| 537 | - } |
|
| 538 | - return '<pre style="color:#999; padding:1em; background: #fff">' . $var . '</pre>'; |
|
| 539 | - } |
|
| 540 | - |
|
| 541 | - |
|
| 542 | - |
|
| 543 | - /** |
|
| 544 | - * @param mixed $var |
|
| 545 | - * @param string $var_name |
|
| 546 | - * @param string $file |
|
| 547 | - * @param int|string $line |
|
| 548 | - * @param int|string $heading_tag |
|
| 549 | - * @param bool $die |
|
| 550 | - */ |
|
| 551 | - public static function printr( |
|
| 552 | - $var, |
|
| 553 | - $var_name = '', |
|
| 554 | - $file = '', |
|
| 555 | - $line = '', |
|
| 556 | - $heading_tag = 5, |
|
| 557 | - $die = false |
|
| 558 | - ) { |
|
| 559 | - // return; |
|
| 560 | - $file = str_replace(rtrim(ABSPATH, '\\/'), '', $file); |
|
| 561 | - if (empty($var) && empty($var_name)) { |
|
| 562 | - $var = $file; |
|
| 563 | - $var_name = "line $line"; |
|
| 564 | - $file = ''; |
|
| 565 | - $line = ''; |
|
| 566 | - } |
|
| 567 | - $margin = is_admin() ? ' 180px' : '0'; |
|
| 568 | - // $print_r = false; |
|
| 569 | - if (is_string($var)) { |
|
| 570 | - EEH_Debug_Tools::printv($var, $var_name, $file, $line, $heading_tag, $die, $margin); |
|
| 571 | - return; |
|
| 572 | - } |
|
| 573 | - if (is_object($var)) { |
|
| 574 | - $var_name = ! $var_name ? 'object' : $var_name; |
|
| 575 | - // $print_r = true; |
|
| 576 | - } elseif (is_array($var)) { |
|
| 577 | - $var_name = ! $var_name ? 'array' : $var_name; |
|
| 578 | - // $print_r = true; |
|
| 579 | - } elseif (is_numeric($var)) { |
|
| 580 | - $var_name = ! $var_name ? 'numeric' : $var_name; |
|
| 581 | - } elseif ($var === null) { |
|
| 582 | - $var_name = ! $var_name ? 'null' : $var_name; |
|
| 583 | - } |
|
| 584 | - $var_name = ucwords(str_replace(array('$', '_'), array('', ' '), $var_name)); |
|
| 585 | - $heading_tag = EEH_Debug_Tools::headingTag($heading_tag); |
|
| 586 | - $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
|
| 587 | - $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
|
| 588 | - $result .= EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span( |
|
| 589 | - EEH_Debug_Tools::pre_span($var) |
|
| 590 | - ); |
|
| 591 | - $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
|
| 592 | - $result .= EEH_Debug_Tools::headingX($heading_tag); |
|
| 593 | - if ($die) { |
|
| 594 | - die($result); |
|
| 595 | - } |
|
| 596 | - echo $result; |
|
| 597 | - } |
|
| 598 | - |
|
| 599 | - |
|
| 600 | - |
|
| 601 | - /******************** deprecated ********************/ |
|
| 602 | - |
|
| 603 | - |
|
| 604 | - |
|
| 605 | - /** |
|
| 606 | - * @deprecated 4.9.39.rc.034 |
|
| 607 | - */ |
|
| 608 | - public function reset_times() |
|
| 609 | - { |
|
| 610 | - Benchmark::resetTimes(); |
|
| 611 | - } |
|
| 612 | - |
|
| 613 | - |
|
| 614 | - |
|
| 615 | - /** |
|
| 616 | - * @deprecated 4.9.39.rc.034 |
|
| 617 | - * @param null $timer_name |
|
| 618 | - */ |
|
| 619 | - public function start_timer($timer_name = null) |
|
| 620 | - { |
|
| 621 | - Benchmark::startTimer($timer_name); |
|
| 622 | - } |
|
| 623 | - |
|
| 624 | - |
|
| 625 | - |
|
| 626 | - /** |
|
| 627 | - * @deprecated 4.9.39.rc.034 |
|
| 628 | - * @param string $timer_name |
|
| 629 | - */ |
|
| 630 | - public function stop_timer($timer_name = '') |
|
| 631 | - { |
|
| 632 | - Benchmark::stopTimer($timer_name); |
|
| 633 | - } |
|
| 634 | - |
|
| 635 | - |
|
| 636 | - |
|
| 637 | - /** |
|
| 638 | - * @deprecated 4.9.39.rc.034 |
|
| 639 | - * @param string $label The label to show for this time eg "Start of calling Some_Class::some_function" |
|
| 640 | - * @param boolean $output_now whether to echo now, or wait until EEH_Debug_Tools::show_times() is called |
|
| 641 | - * @return void |
|
| 642 | - */ |
|
| 643 | - public function measure_memory($label, $output_now = false) |
|
| 644 | - { |
|
| 645 | - Benchmark::measureMemory($label, $output_now); |
|
| 646 | - } |
|
| 647 | - |
|
| 648 | - |
|
| 649 | - |
|
| 650 | - /** |
|
| 651 | - * @deprecated 4.9.39.rc.034 |
|
| 652 | - * @param int $size |
|
| 653 | - * @return string |
|
| 654 | - */ |
|
| 655 | - public function convert($size) |
|
| 656 | - { |
|
| 657 | - return Benchmark::convert($size); |
|
| 658 | - } |
|
| 659 | - |
|
| 660 | - |
|
| 661 | - |
|
| 662 | - /** |
|
| 663 | - * @deprecated 4.9.39.rc.034 |
|
| 664 | - * @param bool $output_now |
|
| 665 | - * @return string |
|
| 666 | - */ |
|
| 667 | - public function show_times($output_now = true) |
|
| 668 | - { |
|
| 669 | - return Benchmark::displayResults($output_now); |
|
| 670 | - } |
|
| 671 | - |
|
| 672 | - |
|
| 673 | - |
|
| 674 | - /** |
|
| 675 | - * @deprecated 4.9.39.rc.034 |
|
| 676 | - * @param string $timer_name |
|
| 677 | - * @param float $total_time |
|
| 678 | - * @return string |
|
| 679 | - */ |
|
| 680 | - public function format_time($timer_name, $total_time) |
|
| 681 | - { |
|
| 682 | - return Benchmark::formatTime($timer_name, $total_time); |
|
| 683 | - } |
|
| 14 | + /** |
|
| 15 | + * instance of the EEH_Autoloader object |
|
| 16 | + * |
|
| 17 | + * @var $_instance |
|
| 18 | + * @access private |
|
| 19 | + */ |
|
| 20 | + private static $_instance; |
|
| 21 | + |
|
| 22 | + /** |
|
| 23 | + * @var array |
|
| 24 | + */ |
|
| 25 | + protected $_memory_usage_points = array(); |
|
| 26 | + |
|
| 27 | + |
|
| 28 | + |
|
| 29 | + /** |
|
| 30 | + * @singleton method used to instantiate class object |
|
| 31 | + * @access public |
|
| 32 | + * @return EEH_Debug_Tools |
|
| 33 | + */ |
|
| 34 | + public static function instance() |
|
| 35 | + { |
|
| 36 | + // check if class object is instantiated, and instantiated properly |
|
| 37 | + if (! self::$_instance instanceof EEH_Debug_Tools) { |
|
| 38 | + self::$_instance = new self(); |
|
| 39 | + } |
|
| 40 | + return self::$_instance; |
|
| 41 | + } |
|
| 42 | + |
|
| 43 | + |
|
| 44 | + |
|
| 45 | + /** |
|
| 46 | + * private class constructor |
|
| 47 | + */ |
|
| 48 | + private function __construct() |
|
| 49 | + { |
|
| 50 | + // load Kint PHP debugging library |
|
| 51 | + if (! class_exists('Kint') && file_exists(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php')) { |
|
| 52 | + // despite EE4 having a check for an existing copy of the Kint debugging class, |
|
| 53 | + // if another plugin was loaded AFTER EE4 and they did NOT perform a similar check, |
|
| 54 | + // then hilarity would ensue as PHP throws a "Cannot redeclare class Kint" error |
|
| 55 | + // so we've moved it to our test folder so that it is not included with production releases |
|
| 56 | + // plz use https://wordpress.org/plugins/kint-debugger/ if testing production versions of EE |
|
| 57 | + require_once(EE_PLUGIN_DIR_PATH . 'tests/kint/Kint.class.php'); |
|
| 58 | + } |
|
| 59 | + // if ( ! defined('DOING_AJAX') || $_REQUEST['noheader'] !== 'true' || ! isset( $_REQUEST['noheader'], $_REQUEST['TB_iframe'] ) ) { |
|
| 60 | + // add_action( 'shutdown', array($this,'espresso_session_footer_dump') ); |
|
| 61 | + // } |
|
| 62 | + $plugin = basename(EE_PLUGIN_DIR_PATH); |
|
| 63 | + add_action("activate_{$plugin}", array('EEH_Debug_Tools', 'ee_plugin_activation_errors')); |
|
| 64 | + add_action('activated_plugin', array('EEH_Debug_Tools', 'ee_plugin_activation_errors')); |
|
| 65 | + add_action('shutdown', array('EEH_Debug_Tools', 'show_db_name')); |
|
| 66 | + } |
|
| 67 | + |
|
| 68 | + |
|
| 69 | + |
|
| 70 | + /** |
|
| 71 | + * show_db_name |
|
| 72 | + * |
|
| 73 | + * @return void |
|
| 74 | + */ |
|
| 75 | + public static function show_db_name() |
|
| 76 | + { |
|
| 77 | + if (! defined('DOING_AJAX') && (defined('EE_ERROR_EMAILS') && EE_ERROR_EMAILS)) { |
|
| 78 | + echo '<p style="font-size:10px;font-weight:normal;color:#E76700;margin: 1em 2em; text-align: right;">DB_NAME: ' |
|
| 79 | + . DB_NAME |
|
| 80 | + . '</p>'; |
|
| 81 | + } |
|
| 82 | + if (EE_DEBUG) { |
|
| 83 | + Benchmark::displayResults(); |
|
| 84 | + } |
|
| 85 | + } |
|
| 86 | + |
|
| 87 | + |
|
| 88 | + |
|
| 89 | + /** |
|
| 90 | + * dump EE_Session object at bottom of page after everything else has happened |
|
| 91 | + * |
|
| 92 | + * @return void |
|
| 93 | + */ |
|
| 94 | + public function espresso_session_footer_dump() |
|
| 95 | + { |
|
| 96 | + if ((defined('WP_DEBUG') && WP_DEBUG) |
|
| 97 | + && ! defined('DOING_AJAX') |
|
| 98 | + && class_exists('Kint') |
|
| 99 | + && function_exists('wp_get_current_user') |
|
| 100 | + && current_user_can('update_core') |
|
| 101 | + && class_exists('EE_Registry') |
|
| 102 | + ) { |
|
| 103 | + Kint::dump(EE_Registry::instance()->SSN->id()); |
|
| 104 | + Kint::dump(EE_Registry::instance()->SSN); |
|
| 105 | + // Kint::dump( EE_Registry::instance()->SSN->get_session_data('cart')->get_tickets() ); |
|
| 106 | + $this->espresso_list_hooked_functions(); |
|
| 107 | + Benchmark::displayResults(); |
|
| 108 | + } |
|
| 109 | + } |
|
| 110 | + |
|
| 111 | + |
|
| 112 | + |
|
| 113 | + /** |
|
| 114 | + * List All Hooked Functions |
|
| 115 | + * to list all functions for a specific hook, add ee_list_hooks={hook-name} to URL |
|
| 116 | + * http://wp.smashingmagazine.com/2009/08/18/10-useful-wordpress-hook-hacks/ |
|
| 117 | + * |
|
| 118 | + * @param string $tag |
|
| 119 | + * @return void |
|
| 120 | + */ |
|
| 121 | + public function espresso_list_hooked_functions($tag = '') |
|
| 122 | + { |
|
| 123 | + global $wp_filter; |
|
| 124 | + echo '<br/><br/><br/><h3>Hooked Functions</h3>'; |
|
| 125 | + if ($tag) { |
|
| 126 | + $hook[ $tag ] = $wp_filter[ $tag ]; |
|
| 127 | + if (! is_array($hook[ $tag ])) { |
|
| 128 | + trigger_error("Nothing found for '$tag' hook", E_USER_WARNING); |
|
| 129 | + return; |
|
| 130 | + } |
|
| 131 | + echo '<h5>For Tag: ' . $tag . '</h5>'; |
|
| 132 | + } else { |
|
| 133 | + $hook = is_array($wp_filter) ? $wp_filter : array($wp_filter); |
|
| 134 | + ksort($hook); |
|
| 135 | + } |
|
| 136 | + foreach ($hook as $tag_name => $priorities) { |
|
| 137 | + echo "<br />>>>>>\t<strong>$tag_name</strong><br />"; |
|
| 138 | + ksort($priorities); |
|
| 139 | + foreach ($priorities as $priority => $function) { |
|
| 140 | + echo $priority; |
|
| 141 | + foreach ($function as $name => $properties) { |
|
| 142 | + echo "\t$name<br />"; |
|
| 143 | + } |
|
| 144 | + } |
|
| 145 | + } |
|
| 146 | + } |
|
| 147 | + |
|
| 148 | + |
|
| 149 | + |
|
| 150 | + /** |
|
| 151 | + * registered_filter_callbacks |
|
| 152 | + * |
|
| 153 | + * @param string $hook_name |
|
| 154 | + * @return array |
|
| 155 | + */ |
|
| 156 | + public static function registered_filter_callbacks($hook_name = '') |
|
| 157 | + { |
|
| 158 | + $filters = array(); |
|
| 159 | + global $wp_filter; |
|
| 160 | + if (isset($wp_filter[ $hook_name ])) { |
|
| 161 | + $filters[ $hook_name ] = array(); |
|
| 162 | + foreach ($wp_filter[ $hook_name ] as $priority => $callbacks) { |
|
| 163 | + $filters[ $hook_name ][ $priority ] = array(); |
|
| 164 | + foreach ($callbacks as $callback) { |
|
| 165 | + $filters[ $hook_name ][ $priority ][] = $callback['function']; |
|
| 166 | + } |
|
| 167 | + } |
|
| 168 | + } |
|
| 169 | + return $filters; |
|
| 170 | + } |
|
| 171 | + |
|
| 172 | + |
|
| 173 | + |
|
| 174 | + /** |
|
| 175 | + * captures plugin activation errors for debugging |
|
| 176 | + * |
|
| 177 | + * @return void |
|
| 178 | + * @throws EE_Error |
|
| 179 | + */ |
|
| 180 | + public static function ee_plugin_activation_errors() |
|
| 181 | + { |
|
| 182 | + if (WP_DEBUG) { |
|
| 183 | + $activation_errors = ob_get_contents(); |
|
| 184 | + if (! empty($activation_errors)) { |
|
| 185 | + $activation_errors = date('Y-m-d H:i:s') . "\n" . $activation_errors; |
|
| 186 | + } |
|
| 187 | + espresso_load_required('EEH_File', EE_HELPERS . 'EEH_File.helper.php'); |
|
| 188 | + if (class_exists('EEH_File')) { |
|
| 189 | + try { |
|
| 190 | + EEH_File::ensure_file_exists_and_is_writable( |
|
| 191 | + EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html' |
|
| 192 | + ); |
|
| 193 | + EEH_File::write_to_file( |
|
| 194 | + EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 195 | + $activation_errors |
|
| 196 | + ); |
|
| 197 | + } catch (EE_Error $e) { |
|
| 198 | + EE_Error::add_error( |
|
| 199 | + sprintf( |
|
| 200 | + __( |
|
| 201 | + 'The Event Espresso activation errors file could not be setup because: %s', |
|
| 202 | + 'event_espresso' |
|
| 203 | + ), |
|
| 204 | + $e->getMessage() |
|
| 205 | + ), |
|
| 206 | + __FILE__, |
|
| 207 | + __FUNCTION__, |
|
| 208 | + __LINE__ |
|
| 209 | + ); |
|
| 210 | + } |
|
| 211 | + } else { |
|
| 212 | + // old school attempt |
|
| 213 | + file_put_contents( |
|
| 214 | + EVENT_ESPRESSO_UPLOAD_DIR . 'logs/espresso_plugin_activation_errors.html', |
|
| 215 | + $activation_errors |
|
| 216 | + ); |
|
| 217 | + } |
|
| 218 | + $activation_errors = get_option('ee_plugin_activation_errors', '') . $activation_errors; |
|
| 219 | + update_option('ee_plugin_activation_errors', $activation_errors); |
|
| 220 | + } |
|
| 221 | + } |
|
| 222 | + |
|
| 223 | + |
|
| 224 | + |
|
| 225 | + /** |
|
| 226 | + * This basically mimics the WordPress _doing_it_wrong() function except adds our own messaging etc. |
|
| 227 | + * Very useful for providing helpful messages to developers when the method of doing something has been deprecated, |
|
| 228 | + * or we want to make sure they use something the right way. |
|
| 229 | + * |
|
| 230 | + * @access public |
|
| 231 | + * @param string $function The function that was called |
|
| 232 | + * @param string $message A message explaining what has been done incorrectly |
|
| 233 | + * @param string $version The version of Event Espresso where the error was added |
|
| 234 | + * @param string $applies_when a version string for when you want the doing_it_wrong notice to begin appearing |
|
| 235 | + * for a deprecated function. This allows deprecation to occur during one version, |
|
| 236 | + * but not have any notices appear until a later version. This allows developers |
|
| 237 | + * extra time to update their code before notices appear. |
|
| 238 | + * @param int $error_type |
|
| 239 | + * @uses trigger_error() |
|
| 240 | + */ |
|
| 241 | + public function doing_it_wrong( |
|
| 242 | + $function, |
|
| 243 | + $message, |
|
| 244 | + $version, |
|
| 245 | + $applies_when = '', |
|
| 246 | + $error_type = null |
|
| 247 | + ) { |
|
| 248 | + $applies_when = ! empty($applies_when) ? $applies_when : espresso_version(); |
|
| 249 | + $error_type = $error_type !== null ? $error_type : E_USER_NOTICE; |
|
| 250 | + // because we swapped the parameter order around for the last two params, |
|
| 251 | + // let's verify that some third party isn't still passing an error type value for the third param |
|
| 252 | + if (is_int($applies_when)) { |
|
| 253 | + $error_type = $applies_when; |
|
| 254 | + $applies_when = espresso_version(); |
|
| 255 | + } |
|
| 256 | + // if not displaying notices yet, then just leave |
|
| 257 | + if (version_compare(espresso_version(), $applies_when, '<')) { |
|
| 258 | + return; |
|
| 259 | + } |
|
| 260 | + do_action('AHEE__EEH_Debug_Tools__doing_it_wrong_run', $function, $message, $version); |
|
| 261 | + $version = $version === null |
|
| 262 | + ? '' |
|
| 263 | + : sprintf( |
|
| 264 | + __('(This message was added in version %s of Event Espresso)', 'event_espresso'), |
|
| 265 | + $version |
|
| 266 | + ); |
|
| 267 | + $error_message = sprintf( |
|
| 268 | + esc_html__('%1$s was called %2$sincorrectly%3$s. %4$s %5$s', 'event_espresso'), |
|
| 269 | + $function, |
|
| 270 | + '<strong>', |
|
| 271 | + '</strong>', |
|
| 272 | + $message, |
|
| 273 | + $version |
|
| 274 | + ); |
|
| 275 | + // don't trigger error if doing ajax, |
|
| 276 | + // instead we'll add a transient EE_Error notice that in theory should show on the next request. |
|
| 277 | + if (defined('DOING_AJAX') && DOING_AJAX) { |
|
| 278 | + $error_message .= ' ' . esc_html__( |
|
| 279 | + 'This is a doing_it_wrong message that was triggered during an ajax request. The request params on this request were: ', |
|
| 280 | + 'event_espresso' |
|
| 281 | + ); |
|
| 282 | + $error_message .= '<ul><li>'; |
|
| 283 | + $error_message .= implode('</li><li>', EE_Registry::instance()->REQ->params()); |
|
| 284 | + $error_message .= '</ul>'; |
|
| 285 | + EE_Error::add_error($error_message, 'debug::doing_it_wrong', $function, '42'); |
|
| 286 | + // now we set this on the transient so it shows up on the next request. |
|
| 287 | + EE_Error::get_notices(false, true); |
|
| 288 | + } else { |
|
| 289 | + trigger_error($error_message, $error_type); |
|
| 290 | + } |
|
| 291 | + } |
|
| 292 | + |
|
| 293 | + |
|
| 294 | + |
|
| 295 | + |
|
| 296 | + /** |
|
| 297 | + * Logger helpers |
|
| 298 | + */ |
|
| 299 | + /** |
|
| 300 | + * debug |
|
| 301 | + * |
|
| 302 | + * @param string $class |
|
| 303 | + * @param string $func |
|
| 304 | + * @param string $line |
|
| 305 | + * @param array $info |
|
| 306 | + * @param bool $display_request |
|
| 307 | + * @param string $debug_index |
|
| 308 | + * @param string $debug_key |
|
| 309 | + * @throws EE_Error |
|
| 310 | + * @throws \EventEspresso\core\exceptions\InvalidSessionDataException |
|
| 311 | + */ |
|
| 312 | + public static function log( |
|
| 313 | + $class = '', |
|
| 314 | + $func = '', |
|
| 315 | + $line = '', |
|
| 316 | + $info = array(), |
|
| 317 | + $display_request = false, |
|
| 318 | + $debug_index = '', |
|
| 319 | + $debug_key = 'EE_DEBUG_SPCO' |
|
| 320 | + ) { |
|
| 321 | + if (WP_DEBUG) { |
|
| 322 | + $debug_key = $debug_key . '_' . EE_Session::instance()->id(); |
|
| 323 | + $debug_data = get_option($debug_key, array()); |
|
| 324 | + $default_data = array( |
|
| 325 | + $class => $func . '() : ' . $line, |
|
| 326 | + 'REQ' => $display_request ? $_REQUEST : '', |
|
| 327 | + ); |
|
| 328 | + // don't serialize objects |
|
| 329 | + $info = self::strip_objects($info); |
|
| 330 | + $index = ! empty($debug_index) ? $debug_index : 0; |
|
| 331 | + if (! isset($debug_data[ $index ])) { |
|
| 332 | + $debug_data[ $index ] = array(); |
|
| 333 | + } |
|
| 334 | + $debug_data[ $index ][ microtime() ] = array_merge($default_data, $info); |
|
| 335 | + update_option($debug_key, $debug_data); |
|
| 336 | + } |
|
| 337 | + } |
|
| 338 | + |
|
| 339 | + |
|
| 340 | + |
|
| 341 | + /** |
|
| 342 | + * strip_objects |
|
| 343 | + * |
|
| 344 | + * @param array $info |
|
| 345 | + * @return array |
|
| 346 | + */ |
|
| 347 | + public static function strip_objects($info = array()) |
|
| 348 | + { |
|
| 349 | + foreach ($info as $key => $value) { |
|
| 350 | + if (is_array($value)) { |
|
| 351 | + $info[ $key ] = self::strip_objects($value); |
|
| 352 | + } elseif (is_object($value)) { |
|
| 353 | + $object_class = get_class($value); |
|
| 354 | + $info[ $object_class ] = array(); |
|
| 355 | + $info[ $object_class ]['ID'] = method_exists($value, 'ID') ? $value->ID() : spl_object_hash($value); |
|
| 356 | + if (method_exists($value, 'ID')) { |
|
| 357 | + $info[ $object_class ]['ID'] = $value->ID(); |
|
| 358 | + } |
|
| 359 | + if (method_exists($value, 'status')) { |
|
| 360 | + $info[ $object_class ]['status'] = $value->status(); |
|
| 361 | + } elseif (method_exists($value, 'status_ID')) { |
|
| 362 | + $info[ $object_class ]['status'] = $value->status_ID(); |
|
| 363 | + } |
|
| 364 | + unset($info[ $key ]); |
|
| 365 | + } |
|
| 366 | + } |
|
| 367 | + return (array) $info; |
|
| 368 | + } |
|
| 369 | + |
|
| 370 | + |
|
| 371 | + |
|
| 372 | + /** |
|
| 373 | + * @param mixed $var |
|
| 374 | + * @param string $var_name |
|
| 375 | + * @param string $file |
|
| 376 | + * @param int|string $line |
|
| 377 | + * @param int|string $heading_tag |
|
| 378 | + * @param bool $die |
|
| 379 | + * @param string $margin |
|
| 380 | + */ |
|
| 381 | + public static function printv( |
|
| 382 | + $var, |
|
| 383 | + $var_name = '', |
|
| 384 | + $file = '', |
|
| 385 | + $line = '', |
|
| 386 | + $heading_tag = 5, |
|
| 387 | + $die = false, |
|
| 388 | + $margin = '' |
|
| 389 | + ) { |
|
| 390 | + $var_name = ! $var_name ? 'string' : $var_name; |
|
| 391 | + $var_name = ucwords(str_replace('$', '', $var_name)); |
|
| 392 | + $is_method = method_exists($var_name, $var); |
|
| 393 | + $var_name = ucwords(str_replace('_', ' ', $var_name)); |
|
| 394 | + $heading_tag = EEH_Debug_Tools::headingTag($heading_tag); |
|
| 395 | + $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
|
| 396 | + $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
|
| 397 | + $result .= $is_method |
|
| 398 | + ? EEH_Debug_Tools::grey_span('::') . EEH_Debug_Tools::orange_span($var . '()') |
|
| 399 | + : EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span($var); |
|
| 400 | + $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
|
| 401 | + $result .= EEH_Debug_Tools::headingX($heading_tag); |
|
| 402 | + if ($die) { |
|
| 403 | + die($result); |
|
| 404 | + } |
|
| 405 | + echo $result; |
|
| 406 | + } |
|
| 407 | + |
|
| 408 | + |
|
| 409 | + protected static function headingTag($heading_tag) |
|
| 410 | + { |
|
| 411 | + $heading_tag = absint($heading_tag); |
|
| 412 | + return $heading_tag > 0 && $heading_tag < 7 ? "h{$heading_tag}" : 'h5'; |
|
| 413 | + } |
|
| 414 | + |
|
| 415 | + |
|
| 416 | + protected static function headingSpacer($heading_tag) |
|
| 417 | + { |
|
| 418 | + return EEH_Debug_Tools::plainOutput() && ($heading_tag === 'h1' || $heading_tag === 'h2') |
|
| 419 | + ? "\n" |
|
| 420 | + : ''; |
|
| 421 | + } |
|
| 422 | + |
|
| 423 | + |
|
| 424 | + protected static function plainOutput() |
|
| 425 | + { |
|
| 426 | + return defined('EE_TESTS_DIR') |
|
| 427 | + || (defined('DOING_AJAX') && DOING_AJAX) |
|
| 428 | + || ( |
|
| 429 | + isset($_SERVER['REQUEST_URI']) |
|
| 430 | + && strpos(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), 'wp-json') !== false |
|
| 431 | + ); |
|
| 432 | + } |
|
| 433 | + |
|
| 434 | + |
|
| 435 | + /** |
|
| 436 | + * @param string $var_name |
|
| 437 | + * @param string $heading_tag |
|
| 438 | + * @param string $margin |
|
| 439 | + * @param int $line |
|
| 440 | + * @return string |
|
| 441 | + */ |
|
| 442 | + protected static function heading($var_name = '', $heading_tag = 'h5', $margin = '', $line = 0) |
|
| 443 | + { |
|
| 444 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 445 | + $heading = ''; |
|
| 446 | + if ($heading_tag === 'h1' || $heading_tag === 'h2') { |
|
| 447 | + $heading .= "\n"; |
|
| 448 | + } |
|
| 449 | + $heading .= "\n{$line}) {$var_name}"; |
|
| 450 | + return $heading; |
|
| 451 | + } |
|
| 452 | + $margin = "25px 0 0 {$margin}"; |
|
| 453 | + return '<' . $heading_tag . ' style="color:#2EA2CC; margin:' . $margin . ';"><b>' . $var_name . '</b>'; |
|
| 454 | + } |
|
| 455 | + |
|
| 456 | + |
|
| 457 | + |
|
| 458 | + /** |
|
| 459 | + * @param string $heading_tag |
|
| 460 | + * @return string |
|
| 461 | + */ |
|
| 462 | + protected static function headingX($heading_tag = 'h5') |
|
| 463 | + { |
|
| 464 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 465 | + return ''; |
|
| 466 | + } |
|
| 467 | + return '</' . $heading_tag . '>'; |
|
| 468 | + } |
|
| 469 | + |
|
| 470 | + |
|
| 471 | + |
|
| 472 | + /** |
|
| 473 | + * @param string $content |
|
| 474 | + * @return string |
|
| 475 | + */ |
|
| 476 | + protected static function grey_span($content = '') |
|
| 477 | + { |
|
| 478 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 479 | + return $content; |
|
| 480 | + } |
|
| 481 | + return '<span style="color:#999">' . $content . '</span>'; |
|
| 482 | + } |
|
| 483 | + |
|
| 484 | + |
|
| 485 | + |
|
| 486 | + /** |
|
| 487 | + * @param string $file |
|
| 488 | + * @param int $line |
|
| 489 | + * @return string |
|
| 490 | + */ |
|
| 491 | + protected static function file_and_line($file, $line, $heading_tag) |
|
| 492 | + { |
|
| 493 | + if ($file === '' || $line === '') { |
|
| 494 | + return ''; |
|
| 495 | + } |
|
| 496 | + $file = str_replace(EE_PLUGIN_DIR_PATH, '/', $file); |
|
| 497 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 498 | + if ($heading_tag === 'h1' || $heading_tag === 'h2') { |
|
| 499 | + return " ({$file})"; |
|
| 500 | + } |
|
| 501 | + return ''; |
|
| 502 | + } |
|
| 503 | + return '<br /><span style="font-size:9px;font-weight:normal;color:#666;line-height: 12px;">' |
|
| 504 | + . $file |
|
| 505 | + . '<br />line no: ' |
|
| 506 | + . $line |
|
| 507 | + . '</span>'; |
|
| 508 | + } |
|
| 509 | + |
|
| 510 | + |
|
| 511 | + |
|
| 512 | + /** |
|
| 513 | + * @param string $content |
|
| 514 | + * @return string |
|
| 515 | + */ |
|
| 516 | + protected static function orange_span($content = '') |
|
| 517 | + { |
|
| 518 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 519 | + return $content; |
|
| 520 | + } |
|
| 521 | + return '<span style="color:#E76700">' . $content . '</span>'; |
|
| 522 | + } |
|
| 523 | + |
|
| 524 | + |
|
| 525 | + |
|
| 526 | + /** |
|
| 527 | + * @param mixed $var |
|
| 528 | + * @return string |
|
| 529 | + */ |
|
| 530 | + protected static function pre_span($var) |
|
| 531 | + { |
|
| 532 | + ob_start(); |
|
| 533 | + var_dump($var); |
|
| 534 | + $var = ob_get_clean(); |
|
| 535 | + if (EEH_Debug_Tools::plainOutput()) { |
|
| 536 | + return $var; |
|
| 537 | + } |
|
| 538 | + return '<pre style="color:#999; padding:1em; background: #fff">' . $var . '</pre>'; |
|
| 539 | + } |
|
| 540 | + |
|
| 541 | + |
|
| 542 | + |
|
| 543 | + /** |
|
| 544 | + * @param mixed $var |
|
| 545 | + * @param string $var_name |
|
| 546 | + * @param string $file |
|
| 547 | + * @param int|string $line |
|
| 548 | + * @param int|string $heading_tag |
|
| 549 | + * @param bool $die |
|
| 550 | + */ |
|
| 551 | + public static function printr( |
|
| 552 | + $var, |
|
| 553 | + $var_name = '', |
|
| 554 | + $file = '', |
|
| 555 | + $line = '', |
|
| 556 | + $heading_tag = 5, |
|
| 557 | + $die = false |
|
| 558 | + ) { |
|
| 559 | + // return; |
|
| 560 | + $file = str_replace(rtrim(ABSPATH, '\\/'), '', $file); |
|
| 561 | + if (empty($var) && empty($var_name)) { |
|
| 562 | + $var = $file; |
|
| 563 | + $var_name = "line $line"; |
|
| 564 | + $file = ''; |
|
| 565 | + $line = ''; |
|
| 566 | + } |
|
| 567 | + $margin = is_admin() ? ' 180px' : '0'; |
|
| 568 | + // $print_r = false; |
|
| 569 | + if (is_string($var)) { |
|
| 570 | + EEH_Debug_Tools::printv($var, $var_name, $file, $line, $heading_tag, $die, $margin); |
|
| 571 | + return; |
|
| 572 | + } |
|
| 573 | + if (is_object($var)) { |
|
| 574 | + $var_name = ! $var_name ? 'object' : $var_name; |
|
| 575 | + // $print_r = true; |
|
| 576 | + } elseif (is_array($var)) { |
|
| 577 | + $var_name = ! $var_name ? 'array' : $var_name; |
|
| 578 | + // $print_r = true; |
|
| 579 | + } elseif (is_numeric($var)) { |
|
| 580 | + $var_name = ! $var_name ? 'numeric' : $var_name; |
|
| 581 | + } elseif ($var === null) { |
|
| 582 | + $var_name = ! $var_name ? 'null' : $var_name; |
|
| 583 | + } |
|
| 584 | + $var_name = ucwords(str_replace(array('$', '_'), array('', ' '), $var_name)); |
|
| 585 | + $heading_tag = EEH_Debug_Tools::headingTag($heading_tag); |
|
| 586 | + $result = EEH_Debug_Tools::headingSpacer($heading_tag); |
|
| 587 | + $result .= EEH_Debug_Tools::heading($var_name, $heading_tag, $margin, $line); |
|
| 588 | + $result .= EEH_Debug_Tools::grey_span(' : ') . EEH_Debug_Tools::orange_span( |
|
| 589 | + EEH_Debug_Tools::pre_span($var) |
|
| 590 | + ); |
|
| 591 | + $result .= EEH_Debug_Tools::file_and_line($file, $line, $heading_tag); |
|
| 592 | + $result .= EEH_Debug_Tools::headingX($heading_tag); |
|
| 593 | + if ($die) { |
|
| 594 | + die($result); |
|
| 595 | + } |
|
| 596 | + echo $result; |
|
| 597 | + } |
|
| 598 | + |
|
| 599 | + |
|
| 600 | + |
|
| 601 | + /******************** deprecated ********************/ |
|
| 602 | + |
|
| 603 | + |
|
| 604 | + |
|
| 605 | + /** |
|
| 606 | + * @deprecated 4.9.39.rc.034 |
|
| 607 | + */ |
|
| 608 | + public function reset_times() |
|
| 609 | + { |
|
| 610 | + Benchmark::resetTimes(); |
|
| 611 | + } |
|
| 612 | + |
|
| 613 | + |
|
| 614 | + |
|
| 615 | + /** |
|
| 616 | + * @deprecated 4.9.39.rc.034 |
|
| 617 | + * @param null $timer_name |
|
| 618 | + */ |
|
| 619 | + public function start_timer($timer_name = null) |
|
| 620 | + { |
|
| 621 | + Benchmark::startTimer($timer_name); |
|
| 622 | + } |
|
| 623 | + |
|
| 624 | + |
|
| 625 | + |
|
| 626 | + /** |
|
| 627 | + * @deprecated 4.9.39.rc.034 |
|
| 628 | + * @param string $timer_name |
|
| 629 | + */ |
|
| 630 | + public function stop_timer($timer_name = '') |
|
| 631 | + { |
|
| 632 | + Benchmark::stopTimer($timer_name); |
|
| 633 | + } |
|
| 634 | + |
|
| 635 | + |
|
| 636 | + |
|
| 637 | + /** |
|
| 638 | + * @deprecated 4.9.39.rc.034 |
|
| 639 | + * @param string $label The label to show for this time eg "Start of calling Some_Class::some_function" |
|
| 640 | + * @param boolean $output_now whether to echo now, or wait until EEH_Debug_Tools::show_times() is called |
|
| 641 | + * @return void |
|
| 642 | + */ |
|
| 643 | + public function measure_memory($label, $output_now = false) |
|
| 644 | + { |
|
| 645 | + Benchmark::measureMemory($label, $output_now); |
|
| 646 | + } |
|
| 647 | + |
|
| 648 | + |
|
| 649 | + |
|
| 650 | + /** |
|
| 651 | + * @deprecated 4.9.39.rc.034 |
|
| 652 | + * @param int $size |
|
| 653 | + * @return string |
|
| 654 | + */ |
|
| 655 | + public function convert($size) |
|
| 656 | + { |
|
| 657 | + return Benchmark::convert($size); |
|
| 658 | + } |
|
| 659 | + |
|
| 660 | + |
|
| 661 | + |
|
| 662 | + /** |
|
| 663 | + * @deprecated 4.9.39.rc.034 |
|
| 664 | + * @param bool $output_now |
|
| 665 | + * @return string |
|
| 666 | + */ |
|
| 667 | + public function show_times($output_now = true) |
|
| 668 | + { |
|
| 669 | + return Benchmark::displayResults($output_now); |
|
| 670 | + } |
|
| 671 | + |
|
| 672 | + |
|
| 673 | + |
|
| 674 | + /** |
|
| 675 | + * @deprecated 4.9.39.rc.034 |
|
| 676 | + * @param string $timer_name |
|
| 677 | + * @param float $total_time |
|
| 678 | + * @return string |
|
| 679 | + */ |
|
| 680 | + public function format_time($timer_name, $total_time) |
|
| 681 | + { |
|
| 682 | + return Benchmark::formatTime($timer_name, $total_time); |
|
| 683 | + } |
|
| 684 | 684 | } |
| 685 | 685 | |
| 686 | 686 | |
@@ -690,31 +690,31 @@ discard block |
||
| 690 | 690 | * Plugin URI: http://upthemes.com/plugins/kint-debugger/ |
| 691 | 691 | */ |
| 692 | 692 | if (class_exists('Kint') && ! function_exists('dump_wp_query')) { |
| 693 | - function dump_wp_query() |
|
| 694 | - { |
|
| 695 | - global $wp_query; |
|
| 696 | - d($wp_query); |
|
| 697 | - } |
|
| 693 | + function dump_wp_query() |
|
| 694 | + { |
|
| 695 | + global $wp_query; |
|
| 696 | + d($wp_query); |
|
| 697 | + } |
|
| 698 | 698 | } |
| 699 | 699 | /** |
| 700 | 700 | * borrowed from Kint Debugger |
| 701 | 701 | * Plugin URI: http://upthemes.com/plugins/kint-debugger/ |
| 702 | 702 | */ |
| 703 | 703 | if (class_exists('Kint') && ! function_exists('dump_wp')) { |
| 704 | - function dump_wp() |
|
| 705 | - { |
|
| 706 | - global $wp; |
|
| 707 | - d($wp); |
|
| 708 | - } |
|
| 704 | + function dump_wp() |
|
| 705 | + { |
|
| 706 | + global $wp; |
|
| 707 | + d($wp); |
|
| 708 | + } |
|
| 709 | 709 | } |
| 710 | 710 | /** |
| 711 | 711 | * borrowed from Kint Debugger |
| 712 | 712 | * Plugin URI: http://upthemes.com/plugins/kint-debugger/ |
| 713 | 713 | */ |
| 714 | 714 | if (class_exists('Kint') && ! function_exists('dump_post')) { |
| 715 | - function dump_post() |
|
| 716 | - { |
|
| 717 | - global $post; |
|
| 718 | - d($post); |
|
| 719 | - } |
|
| 715 | + function dump_post() |
|
| 716 | + { |
|
| 717 | + global $post; |
|
| 718 | + d($post); |
|
| 719 | + } |
|
| 720 | 720 | } |
@@ -51,16 +51,16 @@ discard block |
||
| 51 | 51 | { |
| 52 | 52 | $fqn = $this->getFqn($fqn); |
| 53 | 53 | // have we already seen this FQCN ? |
| 54 | - if (! array_key_exists($fqn, $this->interfaces)) { |
|
| 55 | - $this->interfaces[ $fqn ] = array(); |
|
| 54 | + if ( ! array_key_exists($fqn, $this->interfaces)) { |
|
| 55 | + $this->interfaces[$fqn] = array(); |
|
| 56 | 56 | if (class_exists($fqn)) { |
| 57 | - $this->interfaces[ $fqn ] = class_implements($fqn, false); |
|
| 58 | - $this->interfaces[ $fqn ] = $this->interfaces[ $fqn ] !== false |
|
| 59 | - ? $this->interfaces[ $fqn ] |
|
| 57 | + $this->interfaces[$fqn] = class_implements($fqn, false); |
|
| 58 | + $this->interfaces[$fqn] = $this->interfaces[$fqn] !== false |
|
| 59 | + ? $this->interfaces[$fqn] |
|
| 60 | 60 | : array(); |
| 61 | 61 | } |
| 62 | 62 | } |
| 63 | - return $this->interfaces[ $fqn ]; |
|
| 63 | + return $this->interfaces[$fqn]; |
|
| 64 | 64 | } |
| 65 | 65 | |
| 66 | 66 | |
@@ -91,13 +91,13 @@ discard block |
||
| 91 | 91 | // are we adding an alias for a specific class? |
| 92 | 92 | if ($for_class !== '') { |
| 93 | 93 | // make sure it's set up as an array |
| 94 | - if (! isset($this->aliases[ $for_class ])) { |
|
| 95 | - $this->aliases[ $for_class ] = array(); |
|
| 94 | + if ( ! isset($this->aliases[$for_class])) { |
|
| 95 | + $this->aliases[$for_class] = array(); |
|
| 96 | 96 | } |
| 97 | - $this->aliases[ $for_class ][ $alias ] = $fqn; |
|
| 97 | + $this->aliases[$for_class][$alias] = $fqn; |
|
| 98 | 98 | return; |
| 99 | 99 | } |
| 100 | - $this->aliases[ $alias ] = $fqn; |
|
| 100 | + $this->aliases[$alias] = $fqn; |
|
| 101 | 101 | } |
| 102 | 102 | |
| 103 | 103 | |
@@ -129,7 +129,7 @@ discard block |
||
| 129 | 129 | */ |
| 130 | 130 | protected function isDirectAlias($fqn = '') |
| 131 | 131 | { |
| 132 | - return isset($this->aliases[ (string) $fqn ]) && ! is_array($this->aliases[ (string) $fqn ]); |
|
| 132 | + return isset($this->aliases[(string) $fqn]) && ! is_array($this->aliases[(string) $fqn]); |
|
| 133 | 133 | } |
| 134 | 134 | |
| 135 | 135 | |
@@ -144,7 +144,7 @@ discard block |
||
| 144 | 144 | { |
| 145 | 145 | return ( |
| 146 | 146 | $for_class !== '' |
| 147 | - && isset($this->aliases[ (string) $for_class ][ (string) $fqn ]) |
|
| 147 | + && isset($this->aliases[(string) $for_class][(string) $fqn]) |
|
| 148 | 148 | ); |
| 149 | 149 | } |
| 150 | 150 | |
@@ -169,10 +169,10 @@ discard block |
||
| 169 | 169 | { |
| 170 | 170 | $alias = $this->getFqn($alias); |
| 171 | 171 | if ($this->isAliasForClass($alias, $for_class)) { |
| 172 | - return $this->getFqnForAlias($this->aliases[ (string) $for_class ][ (string) $alias ], $for_class); |
|
| 172 | + return $this->getFqnForAlias($this->aliases[(string) $for_class][(string) $alias], $for_class); |
|
| 173 | 173 | } |
| 174 | 174 | if ($this->isDirectAlias($alias)) { |
| 175 | - return $this->getFqnForAlias($this->aliases[ (string) $alias ], ''); |
|
| 175 | + return $this->getFqnForAlias($this->aliases[(string) $alias], ''); |
|
| 176 | 176 | } |
| 177 | 177 | return $alias; |
| 178 | 178 | } |
@@ -17,165 +17,165 @@ |
||
| 17 | 17 | class ClassInterfaceCache |
| 18 | 18 | { |
| 19 | 19 | |
| 20 | - /** |
|
| 21 | - * array of interfaces indexed by FQCNs where values are arrays of interface FQNs |
|
| 22 | - * |
|
| 23 | - * @var string[][] $interfaces |
|
| 24 | - */ |
|
| 25 | - private $interfaces = array(); |
|
| 26 | - |
|
| 27 | - /** |
|
| 28 | - * @type string[][] $aliases |
|
| 29 | - */ |
|
| 30 | - protected $aliases = array(); |
|
| 31 | - |
|
| 32 | - |
|
| 33 | - /** |
|
| 34 | - * @param string $fqn |
|
| 35 | - * @return string |
|
| 36 | - */ |
|
| 37 | - public function getFqn($fqn) |
|
| 38 | - { |
|
| 39 | - $fqn = $fqn instanceof FullyQualifiedName ? $fqn->string() : $fqn; |
|
| 40 | - return ltrim($fqn, '\\'); |
|
| 41 | - } |
|
| 42 | - |
|
| 43 | - |
|
| 44 | - /** |
|
| 45 | - * @param string $fqn |
|
| 46 | - * @return array |
|
| 47 | - */ |
|
| 48 | - public function getInterfaces($fqn) |
|
| 49 | - { |
|
| 50 | - $fqn = $this->getFqn($fqn); |
|
| 51 | - // have we already seen this FQCN ? |
|
| 52 | - if (! array_key_exists($fqn, $this->interfaces)) { |
|
| 53 | - $this->interfaces[ $fqn ] = array(); |
|
| 54 | - if (class_exists($fqn)) { |
|
| 55 | - $this->interfaces[ $fqn ] = class_implements($fqn, false); |
|
| 56 | - $this->interfaces[ $fqn ] = $this->interfaces[ $fqn ] !== false |
|
| 57 | - ? $this->interfaces[ $fqn ] |
|
| 58 | - : array(); |
|
| 59 | - } |
|
| 60 | - } |
|
| 61 | - return $this->interfaces[ $fqn ]; |
|
| 62 | - } |
|
| 63 | - |
|
| 64 | - |
|
| 65 | - /** |
|
| 66 | - * @param string $fqn |
|
| 67 | - * @param string $interface |
|
| 68 | - * @return bool |
|
| 69 | - */ |
|
| 70 | - public function hasInterface($fqn, $interface) |
|
| 71 | - { |
|
| 72 | - $fqn = $this->getFqn($fqn); |
|
| 73 | - $interfaces = $this->getInterfaces($fqn); |
|
| 74 | - return in_array($interface, $interfaces, true); |
|
| 75 | - } |
|
| 76 | - |
|
| 77 | - |
|
| 78 | - /** |
|
| 79 | - * adds an alias for a classname |
|
| 80 | - * |
|
| 81 | - * @param string $fqn the class name that should be used (concrete class to replace interface) |
|
| 82 | - * @param string $alias the class name that would be type hinted for (abstract parent or interface) |
|
| 83 | - * @param string $for_class the class that has the dependency (is type hinting for the interface) |
|
| 84 | - * @throws InvalidAliasException |
|
| 85 | - */ |
|
| 86 | - public function addAlias($fqn, $alias, $for_class = '') |
|
| 87 | - { |
|
| 88 | - $fqn = $this->getFqn($fqn); |
|
| 89 | - $alias = $this->getFqn($alias); |
|
| 90 | - if (strpos($alias, '\\') !== false && ! is_subclass_of($fqn, $alias)) { |
|
| 91 | - throw new InvalidAliasException($fqn, $alias); |
|
| 92 | - } |
|
| 93 | - // are we adding an alias for a specific class? |
|
| 94 | - if ($for_class !== '') { |
|
| 95 | - // make sure it's set up as an array |
|
| 96 | - if (! isset($this->aliases[ $for_class ])) { |
|
| 97 | - $this->aliases[ $for_class ] = array(); |
|
| 98 | - } |
|
| 99 | - $this->aliases[ $for_class ][ $alias ] = $fqn; |
|
| 100 | - return; |
|
| 101 | - } |
|
| 102 | - $this->aliases[ $alias ] = $fqn; |
|
| 103 | - } |
|
| 104 | - |
|
| 105 | - |
|
| 106 | - /** |
|
| 107 | - * returns TRUE if the provided FQN is an alias |
|
| 108 | - * |
|
| 109 | - * @param string $fqn |
|
| 110 | - * @param string $for_class |
|
| 111 | - * @return bool |
|
| 112 | - */ |
|
| 113 | - public function isAlias($fqn = '', $for_class = '') |
|
| 114 | - { |
|
| 115 | - $fqn = $this->getFqn($fqn); |
|
| 116 | - if ($this->isAliasForClass($fqn, $for_class)) { |
|
| 117 | - return true; |
|
| 118 | - } |
|
| 119 | - if ($this->isDirectAlias($fqn)) { |
|
| 120 | - return true; |
|
| 121 | - } |
|
| 122 | - return false; |
|
| 123 | - } |
|
| 124 | - |
|
| 125 | - |
|
| 126 | - /** |
|
| 127 | - * returns TRUE if the provided FQN is an alias |
|
| 128 | - * |
|
| 129 | - * @param string $fqn |
|
| 130 | - * @return bool |
|
| 131 | - */ |
|
| 132 | - protected function isDirectAlias($fqn = '') |
|
| 133 | - { |
|
| 134 | - return isset($this->aliases[ (string) $fqn ]) && ! is_array($this->aliases[ (string) $fqn ]); |
|
| 135 | - } |
|
| 136 | - |
|
| 137 | - |
|
| 138 | - /** |
|
| 139 | - * returns TRUE if the provided FQN is an alias for the specified class |
|
| 140 | - * |
|
| 141 | - * @param string $fqn |
|
| 142 | - * @param string $for_class |
|
| 143 | - * @return bool |
|
| 144 | - */ |
|
| 145 | - protected function isAliasForClass($fqn = '', $for_class = '') |
|
| 146 | - { |
|
| 147 | - return ( |
|
| 148 | - $for_class !== '' |
|
| 149 | - && isset($this->aliases[ (string) $for_class ][ (string) $fqn ]) |
|
| 150 | - ); |
|
| 151 | - } |
|
| 152 | - |
|
| 153 | - |
|
| 154 | - /** |
|
| 155 | - * returns FQN for provided alias if one exists, otherwise returns the original FQN |
|
| 156 | - * functions recursively, so that multiple aliases can be used to drill down to a FQN |
|
| 157 | - * for example: |
|
| 158 | - * if the following two entries were added to the aliases array: |
|
| 159 | - * array( |
|
| 160 | - * 'interface_alias' => 'some\namespace\interface' |
|
| 161 | - * 'some\namespace\interface' => 'some\namespace\classname' |
|
| 162 | - * ) |
|
| 163 | - * then one could use Loader::getNew( 'interface_alias' ) |
|
| 164 | - * to load an instance of 'some\namespace\classname' |
|
| 165 | - * |
|
| 166 | - * @param string $alias |
|
| 167 | - * @param string $for_class |
|
| 168 | - * @return string |
|
| 169 | - */ |
|
| 170 | - public function getFqnForAlias($alias = '', $for_class = '') |
|
| 171 | - { |
|
| 172 | - $alias = $this->getFqn($alias); |
|
| 173 | - if ($this->isAliasForClass($alias, $for_class)) { |
|
| 174 | - return $this->getFqnForAlias($this->aliases[ (string) $for_class ][ (string) $alias ], $for_class); |
|
| 175 | - } |
|
| 176 | - if ($this->isDirectAlias($alias)) { |
|
| 177 | - return $this->getFqnForAlias($this->aliases[ (string) $alias ], ''); |
|
| 178 | - } |
|
| 179 | - return $alias; |
|
| 180 | - } |
|
| 20 | + /** |
|
| 21 | + * array of interfaces indexed by FQCNs where values are arrays of interface FQNs |
|
| 22 | + * |
|
| 23 | + * @var string[][] $interfaces |
|
| 24 | + */ |
|
| 25 | + private $interfaces = array(); |
|
| 26 | + |
|
| 27 | + /** |
|
| 28 | + * @type string[][] $aliases |
|
| 29 | + */ |
|
| 30 | + protected $aliases = array(); |
|
| 31 | + |
|
| 32 | + |
|
| 33 | + /** |
|
| 34 | + * @param string $fqn |
|
| 35 | + * @return string |
|
| 36 | + */ |
|
| 37 | + public function getFqn($fqn) |
|
| 38 | + { |
|
| 39 | + $fqn = $fqn instanceof FullyQualifiedName ? $fqn->string() : $fqn; |
|
| 40 | + return ltrim($fqn, '\\'); |
|
| 41 | + } |
|
| 42 | + |
|
| 43 | + |
|
| 44 | + /** |
|
| 45 | + * @param string $fqn |
|
| 46 | + * @return array |
|
| 47 | + */ |
|
| 48 | + public function getInterfaces($fqn) |
|
| 49 | + { |
|
| 50 | + $fqn = $this->getFqn($fqn); |
|
| 51 | + // have we already seen this FQCN ? |
|
| 52 | + if (! array_key_exists($fqn, $this->interfaces)) { |
|
| 53 | + $this->interfaces[ $fqn ] = array(); |
|
| 54 | + if (class_exists($fqn)) { |
|
| 55 | + $this->interfaces[ $fqn ] = class_implements($fqn, false); |
|
| 56 | + $this->interfaces[ $fqn ] = $this->interfaces[ $fqn ] !== false |
|
| 57 | + ? $this->interfaces[ $fqn ] |
|
| 58 | + : array(); |
|
| 59 | + } |
|
| 60 | + } |
|
| 61 | + return $this->interfaces[ $fqn ]; |
|
| 62 | + } |
|
| 63 | + |
|
| 64 | + |
|
| 65 | + /** |
|
| 66 | + * @param string $fqn |
|
| 67 | + * @param string $interface |
|
| 68 | + * @return bool |
|
| 69 | + */ |
|
| 70 | + public function hasInterface($fqn, $interface) |
|
| 71 | + { |
|
| 72 | + $fqn = $this->getFqn($fqn); |
|
| 73 | + $interfaces = $this->getInterfaces($fqn); |
|
| 74 | + return in_array($interface, $interfaces, true); |
|
| 75 | + } |
|
| 76 | + |
|
| 77 | + |
|
| 78 | + /** |
|
| 79 | + * adds an alias for a classname |
|
| 80 | + * |
|
| 81 | + * @param string $fqn the class name that should be used (concrete class to replace interface) |
|
| 82 | + * @param string $alias the class name that would be type hinted for (abstract parent or interface) |
|
| 83 | + * @param string $for_class the class that has the dependency (is type hinting for the interface) |
|
| 84 | + * @throws InvalidAliasException |
|
| 85 | + */ |
|
| 86 | + public function addAlias($fqn, $alias, $for_class = '') |
|
| 87 | + { |
|
| 88 | + $fqn = $this->getFqn($fqn); |
|
| 89 | + $alias = $this->getFqn($alias); |
|
| 90 | + if (strpos($alias, '\\') !== false && ! is_subclass_of($fqn, $alias)) { |
|
| 91 | + throw new InvalidAliasException($fqn, $alias); |
|
| 92 | + } |
|
| 93 | + // are we adding an alias for a specific class? |
|
| 94 | + if ($for_class !== '') { |
|
| 95 | + // make sure it's set up as an array |
|
| 96 | + if (! isset($this->aliases[ $for_class ])) { |
|
| 97 | + $this->aliases[ $for_class ] = array(); |
|
| 98 | + } |
|
| 99 | + $this->aliases[ $for_class ][ $alias ] = $fqn; |
|
| 100 | + return; |
|
| 101 | + } |
|
| 102 | + $this->aliases[ $alias ] = $fqn; |
|
| 103 | + } |
|
| 104 | + |
|
| 105 | + |
|
| 106 | + /** |
|
| 107 | + * returns TRUE if the provided FQN is an alias |
|
| 108 | + * |
|
| 109 | + * @param string $fqn |
|
| 110 | + * @param string $for_class |
|
| 111 | + * @return bool |
|
| 112 | + */ |
|
| 113 | + public function isAlias($fqn = '', $for_class = '') |
|
| 114 | + { |
|
| 115 | + $fqn = $this->getFqn($fqn); |
|
| 116 | + if ($this->isAliasForClass($fqn, $for_class)) { |
|
| 117 | + return true; |
|
| 118 | + } |
|
| 119 | + if ($this->isDirectAlias($fqn)) { |
|
| 120 | + return true; |
|
| 121 | + } |
|
| 122 | + return false; |
|
| 123 | + } |
|
| 124 | + |
|
| 125 | + |
|
| 126 | + /** |
|
| 127 | + * returns TRUE if the provided FQN is an alias |
|
| 128 | + * |
|
| 129 | + * @param string $fqn |
|
| 130 | + * @return bool |
|
| 131 | + */ |
|
| 132 | + protected function isDirectAlias($fqn = '') |
|
| 133 | + { |
|
| 134 | + return isset($this->aliases[ (string) $fqn ]) && ! is_array($this->aliases[ (string) $fqn ]); |
|
| 135 | + } |
|
| 136 | + |
|
| 137 | + |
|
| 138 | + /** |
|
| 139 | + * returns TRUE if the provided FQN is an alias for the specified class |
|
| 140 | + * |
|
| 141 | + * @param string $fqn |
|
| 142 | + * @param string $for_class |
|
| 143 | + * @return bool |
|
| 144 | + */ |
|
| 145 | + protected function isAliasForClass($fqn = '', $for_class = '') |
|
| 146 | + { |
|
| 147 | + return ( |
|
| 148 | + $for_class !== '' |
|
| 149 | + && isset($this->aliases[ (string) $for_class ][ (string) $fqn ]) |
|
| 150 | + ); |
|
| 151 | + } |
|
| 152 | + |
|
| 153 | + |
|
| 154 | + /** |
|
| 155 | + * returns FQN for provided alias if one exists, otherwise returns the original FQN |
|
| 156 | + * functions recursively, so that multiple aliases can be used to drill down to a FQN |
|
| 157 | + * for example: |
|
| 158 | + * if the following two entries were added to the aliases array: |
|
| 159 | + * array( |
|
| 160 | + * 'interface_alias' => 'some\namespace\interface' |
|
| 161 | + * 'some\namespace\interface' => 'some\namespace\classname' |
|
| 162 | + * ) |
|
| 163 | + * then one could use Loader::getNew( 'interface_alias' ) |
|
| 164 | + * to load an instance of 'some\namespace\classname' |
|
| 165 | + * |
|
| 166 | + * @param string $alias |
|
| 167 | + * @param string $for_class |
|
| 168 | + * @return string |
|
| 169 | + */ |
|
| 170 | + public function getFqnForAlias($alias = '', $for_class = '') |
|
| 171 | + { |
|
| 172 | + $alias = $this->getFqn($alias); |
|
| 173 | + if ($this->isAliasForClass($alias, $for_class)) { |
|
| 174 | + return $this->getFqnForAlias($this->aliases[ (string) $for_class ][ (string) $alias ], $for_class); |
|
| 175 | + } |
|
| 176 | + if ($this->isDirectAlias($alias)) { |
|
| 177 | + return $this->getFqnForAlias($this->aliases[ (string) $alias ], ''); |
|
| 178 | + } |
|
| 179 | + return $alias; |
|
| 180 | + } |
|
| 181 | 181 | } |
@@ -61,7 +61,7 @@ |
||
| 61 | 61 | { |
| 62 | 62 | $custom_post_types = $this->custom_post_types->getDefinitions(); |
| 63 | 63 | foreach ($custom_post_types as $custom_post_type => $CPT) { |
| 64 | - $this->wp_post_types[ $custom_post_type ] = $this->registerCustomPostType( |
|
| 64 | + $this->wp_post_types[$custom_post_type] = $this->registerCustomPostType( |
|
| 65 | 65 | $custom_post_type, |
| 66 | 66 | $CPT['singular_name'], |
| 67 | 67 | $CPT['plural_name'], |
@@ -18,314 +18,314 @@ |
||
| 18 | 18 | class RegisterCustomPostTypes |
| 19 | 19 | { |
| 20 | 20 | |
| 21 | - /** |
|
| 22 | - * @var CustomPostTypeDefinitions $custom_post_types |
|
| 23 | - */ |
|
| 24 | - public $custom_post_types; |
|
| 21 | + /** |
|
| 22 | + * @var CustomPostTypeDefinitions $custom_post_types |
|
| 23 | + */ |
|
| 24 | + public $custom_post_types; |
|
| 25 | 25 | |
| 26 | - /** |
|
| 27 | - * @var WP_Post_Type[] $wp_post_types |
|
| 28 | - */ |
|
| 29 | - public $wp_post_types = array(); |
|
| 26 | + /** |
|
| 27 | + * @var WP_Post_Type[] $wp_post_types |
|
| 28 | + */ |
|
| 29 | + public $wp_post_types = array(); |
|
| 30 | 30 | |
| 31 | 31 | |
| 32 | - /** |
|
| 33 | - * RegisterCustomPostTypes constructor. |
|
| 34 | - * |
|
| 35 | - * @param CustomPostTypeDefinitions $custom_post_types |
|
| 36 | - */ |
|
| 37 | - public function __construct(CustomPostTypeDefinitions $custom_post_types) |
|
| 38 | - { |
|
| 39 | - $this->custom_post_types = $custom_post_types; |
|
| 40 | - } |
|
| 32 | + /** |
|
| 33 | + * RegisterCustomPostTypes constructor. |
|
| 34 | + * |
|
| 35 | + * @param CustomPostTypeDefinitions $custom_post_types |
|
| 36 | + */ |
|
| 37 | + public function __construct(CustomPostTypeDefinitions $custom_post_types) |
|
| 38 | + { |
|
| 39 | + $this->custom_post_types = $custom_post_types; |
|
| 40 | + } |
|
| 41 | 41 | |
| 42 | 42 | |
| 43 | - /** |
|
| 44 | - * @return WP_Post_Type[] |
|
| 45 | - */ |
|
| 46 | - public function getRegisteredCustomPostTypes() |
|
| 47 | - { |
|
| 48 | - return $this->wp_post_types; |
|
| 49 | - } |
|
| 43 | + /** |
|
| 44 | + * @return WP_Post_Type[] |
|
| 45 | + */ |
|
| 46 | + public function getRegisteredCustomPostTypes() |
|
| 47 | + { |
|
| 48 | + return $this->wp_post_types; |
|
| 49 | + } |
|
| 50 | 50 | |
| 51 | 51 | |
| 52 | - /** |
|
| 53 | - * @return void |
|
| 54 | - * @throws DomainException |
|
| 55 | - */ |
|
| 56 | - public function registerCustomPostTypes() |
|
| 57 | - { |
|
| 58 | - $custom_post_types = $this->custom_post_types->getDefinitions(); |
|
| 59 | - foreach ($custom_post_types as $custom_post_type => $CPT) { |
|
| 60 | - $this->wp_post_types[ $custom_post_type ] = $this->registerCustomPostType( |
|
| 61 | - $custom_post_type, |
|
| 62 | - $CPT['singular_name'], |
|
| 63 | - $CPT['plural_name'], |
|
| 64 | - $CPT['singular_slug'], |
|
| 65 | - $CPT['plural_slug'], |
|
| 66 | - $CPT['args'] |
|
| 67 | - ); |
|
| 68 | - } |
|
| 69 | - } |
|
| 52 | + /** |
|
| 53 | + * @return void |
|
| 54 | + * @throws DomainException |
|
| 55 | + */ |
|
| 56 | + public function registerCustomPostTypes() |
|
| 57 | + { |
|
| 58 | + $custom_post_types = $this->custom_post_types->getDefinitions(); |
|
| 59 | + foreach ($custom_post_types as $custom_post_type => $CPT) { |
|
| 60 | + $this->wp_post_types[ $custom_post_type ] = $this->registerCustomPostType( |
|
| 61 | + $custom_post_type, |
|
| 62 | + $CPT['singular_name'], |
|
| 63 | + $CPT['plural_name'], |
|
| 64 | + $CPT['singular_slug'], |
|
| 65 | + $CPT['plural_slug'], |
|
| 66 | + $CPT['args'] |
|
| 67 | + ); |
|
| 68 | + } |
|
| 69 | + } |
|
| 70 | 70 | |
| 71 | 71 | |
| 72 | - /** |
|
| 73 | - * Registers a new custom post type. Sets default settings given only the following params. |
|
| 74 | - * Returns the registered post type object, or an error object. |
|
| 75 | - * |
|
| 76 | - * @param string $post_type the actual post type name |
|
| 77 | - * IMPORTANT: |
|
| 78 | - * this must match what the slug is for admin pages related to this CPT |
|
| 79 | - * Also any models must use this slug as well |
|
| 80 | - * @param string $singular_name a pre-internationalized string for the singular name of the objects |
|
| 81 | - * @param string $plural_name a pre-internationalized string for the plural name of the objects |
|
| 82 | - * @param string $singular_slug |
|
| 83 | - * @param string $plural_slug |
|
| 84 | - * @param array $override_arguments exactly like $args as described in |
|
| 85 | - * http://codex.wordpress.org/Function_Reference/register_post_type |
|
| 86 | - * @return WP_Post_Type|WP_Error |
|
| 87 | - * @throws DomainException |
|
| 88 | - */ |
|
| 89 | - public function registerCustomPostType( |
|
| 90 | - $post_type, |
|
| 91 | - $singular_name, |
|
| 92 | - $plural_name, |
|
| 93 | - $singular_slug = '', |
|
| 94 | - $plural_slug = '', |
|
| 95 | - array $override_arguments = array() |
|
| 96 | - ) { |
|
| 97 | - $wp_post_type = register_post_type( |
|
| 98 | - $post_type, |
|
| 99 | - $this->prepareArguments( |
|
| 100 | - $post_type, |
|
| 101 | - $singular_name, |
|
| 102 | - $plural_name, |
|
| 103 | - $singular_slug, |
|
| 104 | - $plural_slug, |
|
| 105 | - $override_arguments |
|
| 106 | - ) |
|
| 107 | - ); |
|
| 108 | - if ($wp_post_type instanceof WP_Error) { |
|
| 109 | - throw new DomainException($wp_post_type->get_error_message()); |
|
| 110 | - } |
|
| 111 | - return $wp_post_type; |
|
| 112 | - } |
|
| 72 | + /** |
|
| 73 | + * Registers a new custom post type. Sets default settings given only the following params. |
|
| 74 | + * Returns the registered post type object, or an error object. |
|
| 75 | + * |
|
| 76 | + * @param string $post_type the actual post type name |
|
| 77 | + * IMPORTANT: |
|
| 78 | + * this must match what the slug is for admin pages related to this CPT |
|
| 79 | + * Also any models must use this slug as well |
|
| 80 | + * @param string $singular_name a pre-internationalized string for the singular name of the objects |
|
| 81 | + * @param string $plural_name a pre-internationalized string for the plural name of the objects |
|
| 82 | + * @param string $singular_slug |
|
| 83 | + * @param string $plural_slug |
|
| 84 | + * @param array $override_arguments exactly like $args as described in |
|
| 85 | + * http://codex.wordpress.org/Function_Reference/register_post_type |
|
| 86 | + * @return WP_Post_Type|WP_Error |
|
| 87 | + * @throws DomainException |
|
| 88 | + */ |
|
| 89 | + public function registerCustomPostType( |
|
| 90 | + $post_type, |
|
| 91 | + $singular_name, |
|
| 92 | + $plural_name, |
|
| 93 | + $singular_slug = '', |
|
| 94 | + $plural_slug = '', |
|
| 95 | + array $override_arguments = array() |
|
| 96 | + ) { |
|
| 97 | + $wp_post_type = register_post_type( |
|
| 98 | + $post_type, |
|
| 99 | + $this->prepareArguments( |
|
| 100 | + $post_type, |
|
| 101 | + $singular_name, |
|
| 102 | + $plural_name, |
|
| 103 | + $singular_slug, |
|
| 104 | + $plural_slug, |
|
| 105 | + $override_arguments |
|
| 106 | + ) |
|
| 107 | + ); |
|
| 108 | + if ($wp_post_type instanceof WP_Error) { |
|
| 109 | + throw new DomainException($wp_post_type->get_error_message()); |
|
| 110 | + } |
|
| 111 | + return $wp_post_type; |
|
| 112 | + } |
|
| 113 | 113 | |
| 114 | 114 | |
| 115 | - /** |
|
| 116 | - * @param string $post_type the actual post type name |
|
| 117 | - * @param string $singular_name a pre-internationalized string for the singular name of the objects |
|
| 118 | - * @param string $plural_name a pre-internationalized string for the plural name of the objects |
|
| 119 | - * @param string $singular_slug |
|
| 120 | - * @param string $plural_slug |
|
| 121 | - * @param array $override_arguments The default values set in this function will be overridden |
|
| 122 | - * by whatever you set in $override_arguments |
|
| 123 | - * @return array |
|
| 124 | - */ |
|
| 125 | - protected function prepareArguments( |
|
| 126 | - $post_type, |
|
| 127 | - $singular_name, |
|
| 128 | - $plural_name, |
|
| 129 | - $singular_slug, |
|
| 130 | - $plural_slug, |
|
| 131 | - array $override_arguments = array() |
|
| 132 | - ) { |
|
| 133 | - // verify plural slug and singular slug, if they aren't we'll use $singular_name and $plural_name |
|
| 134 | - $singular_slug = ! empty($singular_slug) ? $singular_slug : $singular_name; |
|
| 135 | - $plural_slug = ! empty($plural_slug) ? $plural_slug : $plural_name; |
|
| 136 | - $labels = $this->getLabels( |
|
| 137 | - $singular_name, |
|
| 138 | - $plural_name, |
|
| 139 | - $singular_slug, |
|
| 140 | - $plural_slug |
|
| 141 | - ); |
|
| 142 | - // note the page_templates arg in the supports index is something specific to EE. |
|
| 143 | - // WordPress doesn't actually have that in their register_post_type api. |
|
| 144 | - $arguments = $this->getDefaultArguments($labels, $post_type, $plural_slug); |
|
| 145 | - if ($override_arguments) { |
|
| 146 | - if (isset($override_arguments['labels'])) { |
|
| 147 | - $labels = array_merge($arguments['labels'], $override_arguments['labels']); |
|
| 148 | - } |
|
| 149 | - $arguments = array_merge($arguments, $override_arguments); |
|
| 150 | - $arguments['labels'] = $labels; |
|
| 151 | - } |
|
| 152 | - return $arguments; |
|
| 153 | - } |
|
| 115 | + /** |
|
| 116 | + * @param string $post_type the actual post type name |
|
| 117 | + * @param string $singular_name a pre-internationalized string for the singular name of the objects |
|
| 118 | + * @param string $plural_name a pre-internationalized string for the plural name of the objects |
|
| 119 | + * @param string $singular_slug |
|
| 120 | + * @param string $plural_slug |
|
| 121 | + * @param array $override_arguments The default values set in this function will be overridden |
|
| 122 | + * by whatever you set in $override_arguments |
|
| 123 | + * @return array |
|
| 124 | + */ |
|
| 125 | + protected function prepareArguments( |
|
| 126 | + $post_type, |
|
| 127 | + $singular_name, |
|
| 128 | + $plural_name, |
|
| 129 | + $singular_slug, |
|
| 130 | + $plural_slug, |
|
| 131 | + array $override_arguments = array() |
|
| 132 | + ) { |
|
| 133 | + // verify plural slug and singular slug, if they aren't we'll use $singular_name and $plural_name |
|
| 134 | + $singular_slug = ! empty($singular_slug) ? $singular_slug : $singular_name; |
|
| 135 | + $plural_slug = ! empty($plural_slug) ? $plural_slug : $plural_name; |
|
| 136 | + $labels = $this->getLabels( |
|
| 137 | + $singular_name, |
|
| 138 | + $plural_name, |
|
| 139 | + $singular_slug, |
|
| 140 | + $plural_slug |
|
| 141 | + ); |
|
| 142 | + // note the page_templates arg in the supports index is something specific to EE. |
|
| 143 | + // WordPress doesn't actually have that in their register_post_type api. |
|
| 144 | + $arguments = $this->getDefaultArguments($labels, $post_type, $plural_slug); |
|
| 145 | + if ($override_arguments) { |
|
| 146 | + if (isset($override_arguments['labels'])) { |
|
| 147 | + $labels = array_merge($arguments['labels'], $override_arguments['labels']); |
|
| 148 | + } |
|
| 149 | + $arguments = array_merge($arguments, $override_arguments); |
|
| 150 | + $arguments['labels'] = $labels; |
|
| 151 | + } |
|
| 152 | + return $arguments; |
|
| 153 | + } |
|
| 154 | 154 | |
| 155 | 155 | |
| 156 | - /** |
|
| 157 | - * @param string $singular_name |
|
| 158 | - * @param string $plural_name |
|
| 159 | - * @param string $singular_slug |
|
| 160 | - * @param string $plural_slug |
|
| 161 | - * @return array |
|
| 162 | - */ |
|
| 163 | - private function getLabels($singular_name, $plural_name, $singular_slug, $plural_slug) |
|
| 164 | - { |
|
| 165 | - return array( |
|
| 166 | - 'name' => $plural_name, |
|
| 167 | - 'singular_name' => $singular_name, |
|
| 168 | - 'singular_slug' => $singular_slug, |
|
| 169 | - 'plural_slug' => $plural_slug, |
|
| 170 | - 'add_new' => sprintf( |
|
| 171 | - /* Translators: Post Type Label */ |
|
| 172 | - esc_html_x('Add %s', 'Add Event', 'event_espresso'), |
|
| 173 | - $singular_name |
|
| 174 | - ), |
|
| 175 | - 'add_new_item' => sprintf( |
|
| 176 | - /* Translators: Post Type Label */ |
|
| 177 | - esc_html_x('Add New %s', 'Add New Event', 'event_espresso'), |
|
| 178 | - $singular_name |
|
| 179 | - ), |
|
| 180 | - 'edit_item' => sprintf( |
|
| 181 | - /* Translators: Post Type Label */ |
|
| 182 | - esc_html_x('Edit %s', 'Edit Event', 'event_espresso'), |
|
| 183 | - $singular_name |
|
| 184 | - ), |
|
| 185 | - 'new_item' => sprintf( |
|
| 186 | - /* Translators: Post Type Label */ |
|
| 187 | - esc_html_x('New %s', 'New Event', 'event_espresso'), |
|
| 188 | - $singular_name |
|
| 189 | - ), |
|
| 190 | - 'all_items' => sprintf( |
|
| 191 | - /* Translators: Post Type Label */ |
|
| 192 | - esc_html_x('All %s', 'All Events', 'event_espresso'), |
|
| 193 | - $plural_name |
|
| 194 | - ), |
|
| 195 | - 'view_item' => sprintf( |
|
| 196 | - /* Translators: Post Type Label */ |
|
| 197 | - esc_html_x('View %s', 'View Event', 'event_espresso'), |
|
| 198 | - $singular_name |
|
| 199 | - ), |
|
| 200 | - 'view_items' => sprintf( |
|
| 201 | - /* Translators: Post Type Label */ |
|
| 202 | - esc_html_x('View %s', 'View Events', 'event_espresso'), |
|
| 203 | - $plural_name |
|
| 204 | - ), |
|
| 205 | - 'archives' => sprintf( |
|
| 206 | - /* Translators: Post Type Label */ |
|
| 207 | - esc_html_x('%s Archives', 'Event Archives', 'event_espresso'), |
|
| 208 | - $singular_name |
|
| 209 | - ), |
|
| 210 | - 'attributes' => sprintf( |
|
| 211 | - /* Translators: Post Type Label */ |
|
| 212 | - esc_html_x('%s Attributes', 'Event Attributes', 'event_espresso'), |
|
| 213 | - $singular_name |
|
| 214 | - ), |
|
| 215 | - 'insert_into_item' => sprintf( |
|
| 216 | - /* Translators: Post Type Label */ |
|
| 217 | - esc_html_x('Insert into this %s', 'Insert into this Event', 'event_espresso'), |
|
| 218 | - $singular_name |
|
| 219 | - ), |
|
| 220 | - 'uploaded_to_this_item' => sprintf( |
|
| 221 | - /* Translators: Post Type Label */ |
|
| 222 | - esc_html_x('Uploaded to this %s', 'Uploaded to this Event', 'event_espresso'), |
|
| 223 | - $singular_name |
|
| 224 | - ), |
|
| 225 | - 'filter_items_list' => sprintf( |
|
| 226 | - /* Translators: Post Type Label */ |
|
| 227 | - esc_html_x('Filter %s list', 'Filter Events list', 'event_espresso'), |
|
| 228 | - $plural_name |
|
| 229 | - ), |
|
| 230 | - 'items_list_navigation' => sprintf( |
|
| 231 | - /* Translators: Post Type Label */ |
|
| 232 | - esc_html_x('%s list navigation', 'Events list navigation', 'event_espresso'), |
|
| 233 | - $plural_name |
|
| 234 | - ), |
|
| 235 | - 'items_list' => sprintf( |
|
| 236 | - /* Translators: Post Type Label */ |
|
| 237 | - esc_html_x('%s list', 'Events list', 'event_espresso'), |
|
| 238 | - $plural_name |
|
| 239 | - ), |
|
| 240 | - 'item_published' => sprintf( |
|
| 241 | - /* Translators: Post Type Label */ |
|
| 242 | - esc_html_x('%s published', 'Event published', 'event_espresso'), |
|
| 243 | - $singular_name |
|
| 244 | - ), |
|
| 245 | - 'item_published_privately' => sprintf( |
|
| 246 | - /* Translators: Post Type Label */ |
|
| 247 | - esc_html_x('%s published privately', 'Event published privately', 'event_espresso'), |
|
| 248 | - $singular_name |
|
| 249 | - ), |
|
| 250 | - 'item_reverted_to_draft' => sprintf( |
|
| 251 | - /* Translators: Post Type Label */ |
|
| 252 | - esc_html_x('%s reverted to draft', 'Event reverted to draft', 'event_espresso'), |
|
| 253 | - $singular_name |
|
| 254 | - ), |
|
| 255 | - 'item_scheduled' => sprintf( |
|
| 256 | - /* Translators: Post Type Label */ |
|
| 257 | - esc_html_x('%s scheduled', 'Event scheduled', 'event_espresso'), |
|
| 258 | - $singular_name |
|
| 259 | - ), |
|
| 260 | - 'item_updated' => sprintf( |
|
| 261 | - /* Translators: Post Type Label */ |
|
| 262 | - esc_html_x('%s updated', 'Event updated', 'event_espresso'), |
|
| 263 | - $singular_name |
|
| 264 | - ), |
|
| 265 | - 'search_items' => sprintf( |
|
| 266 | - /* Translators: Post Type Label */ |
|
| 267 | - esc_html_x('Search %s', 'Search Events', 'event_espresso'), |
|
| 268 | - $plural_name |
|
| 269 | - ), |
|
| 270 | - 'not_found' => sprintf( |
|
| 271 | - /* Translators: Post Type Label */ |
|
| 272 | - esc_html_x('No %s found', 'No Events found', 'event_espresso'), |
|
| 273 | - $plural_name |
|
| 274 | - ), |
|
| 275 | - 'not_found_in_trash' => sprintf( |
|
| 276 | - /* Translators: Post Type Label */ |
|
| 277 | - esc_html_x('No %s found in Trash', 'No Events found in Trash', 'event_espresso'), |
|
| 278 | - $plural_name |
|
| 279 | - ), |
|
| 280 | - 'parent_item_colon' => '', |
|
| 281 | - 'menu_name' => $plural_name, |
|
| 282 | - ); |
|
| 283 | - } |
|
| 156 | + /** |
|
| 157 | + * @param string $singular_name |
|
| 158 | + * @param string $plural_name |
|
| 159 | + * @param string $singular_slug |
|
| 160 | + * @param string $plural_slug |
|
| 161 | + * @return array |
|
| 162 | + */ |
|
| 163 | + private function getLabels($singular_name, $plural_name, $singular_slug, $plural_slug) |
|
| 164 | + { |
|
| 165 | + return array( |
|
| 166 | + 'name' => $plural_name, |
|
| 167 | + 'singular_name' => $singular_name, |
|
| 168 | + 'singular_slug' => $singular_slug, |
|
| 169 | + 'plural_slug' => $plural_slug, |
|
| 170 | + 'add_new' => sprintf( |
|
| 171 | + /* Translators: Post Type Label */ |
|
| 172 | + esc_html_x('Add %s', 'Add Event', 'event_espresso'), |
|
| 173 | + $singular_name |
|
| 174 | + ), |
|
| 175 | + 'add_new_item' => sprintf( |
|
| 176 | + /* Translators: Post Type Label */ |
|
| 177 | + esc_html_x('Add New %s', 'Add New Event', 'event_espresso'), |
|
| 178 | + $singular_name |
|
| 179 | + ), |
|
| 180 | + 'edit_item' => sprintf( |
|
| 181 | + /* Translators: Post Type Label */ |
|
| 182 | + esc_html_x('Edit %s', 'Edit Event', 'event_espresso'), |
|
| 183 | + $singular_name |
|
| 184 | + ), |
|
| 185 | + 'new_item' => sprintf( |
|
| 186 | + /* Translators: Post Type Label */ |
|
| 187 | + esc_html_x('New %s', 'New Event', 'event_espresso'), |
|
| 188 | + $singular_name |
|
| 189 | + ), |
|
| 190 | + 'all_items' => sprintf( |
|
| 191 | + /* Translators: Post Type Label */ |
|
| 192 | + esc_html_x('All %s', 'All Events', 'event_espresso'), |
|
| 193 | + $plural_name |
|
| 194 | + ), |
|
| 195 | + 'view_item' => sprintf( |
|
| 196 | + /* Translators: Post Type Label */ |
|
| 197 | + esc_html_x('View %s', 'View Event', 'event_espresso'), |
|
| 198 | + $singular_name |
|
| 199 | + ), |
|
| 200 | + 'view_items' => sprintf( |
|
| 201 | + /* Translators: Post Type Label */ |
|
| 202 | + esc_html_x('View %s', 'View Events', 'event_espresso'), |
|
| 203 | + $plural_name |
|
| 204 | + ), |
|
| 205 | + 'archives' => sprintf( |
|
| 206 | + /* Translators: Post Type Label */ |
|
| 207 | + esc_html_x('%s Archives', 'Event Archives', 'event_espresso'), |
|
| 208 | + $singular_name |
|
| 209 | + ), |
|
| 210 | + 'attributes' => sprintf( |
|
| 211 | + /* Translators: Post Type Label */ |
|
| 212 | + esc_html_x('%s Attributes', 'Event Attributes', 'event_espresso'), |
|
| 213 | + $singular_name |
|
| 214 | + ), |
|
| 215 | + 'insert_into_item' => sprintf( |
|
| 216 | + /* Translators: Post Type Label */ |
|
| 217 | + esc_html_x('Insert into this %s', 'Insert into this Event', 'event_espresso'), |
|
| 218 | + $singular_name |
|
| 219 | + ), |
|
| 220 | + 'uploaded_to_this_item' => sprintf( |
|
| 221 | + /* Translators: Post Type Label */ |
|
| 222 | + esc_html_x('Uploaded to this %s', 'Uploaded to this Event', 'event_espresso'), |
|
| 223 | + $singular_name |
|
| 224 | + ), |
|
| 225 | + 'filter_items_list' => sprintf( |
|
| 226 | + /* Translators: Post Type Label */ |
|
| 227 | + esc_html_x('Filter %s list', 'Filter Events list', 'event_espresso'), |
|
| 228 | + $plural_name |
|
| 229 | + ), |
|
| 230 | + 'items_list_navigation' => sprintf( |
|
| 231 | + /* Translators: Post Type Label */ |
|
| 232 | + esc_html_x('%s list navigation', 'Events list navigation', 'event_espresso'), |
|
| 233 | + $plural_name |
|
| 234 | + ), |
|
| 235 | + 'items_list' => sprintf( |
|
| 236 | + /* Translators: Post Type Label */ |
|
| 237 | + esc_html_x('%s list', 'Events list', 'event_espresso'), |
|
| 238 | + $plural_name |
|
| 239 | + ), |
|
| 240 | + 'item_published' => sprintf( |
|
| 241 | + /* Translators: Post Type Label */ |
|
| 242 | + esc_html_x('%s published', 'Event published', 'event_espresso'), |
|
| 243 | + $singular_name |
|
| 244 | + ), |
|
| 245 | + 'item_published_privately' => sprintf( |
|
| 246 | + /* Translators: Post Type Label */ |
|
| 247 | + esc_html_x('%s published privately', 'Event published privately', 'event_espresso'), |
|
| 248 | + $singular_name |
|
| 249 | + ), |
|
| 250 | + 'item_reverted_to_draft' => sprintf( |
|
| 251 | + /* Translators: Post Type Label */ |
|
| 252 | + esc_html_x('%s reverted to draft', 'Event reverted to draft', 'event_espresso'), |
|
| 253 | + $singular_name |
|
| 254 | + ), |
|
| 255 | + 'item_scheduled' => sprintf( |
|
| 256 | + /* Translators: Post Type Label */ |
|
| 257 | + esc_html_x('%s scheduled', 'Event scheduled', 'event_espresso'), |
|
| 258 | + $singular_name |
|
| 259 | + ), |
|
| 260 | + 'item_updated' => sprintf( |
|
| 261 | + /* Translators: Post Type Label */ |
|
| 262 | + esc_html_x('%s updated', 'Event updated', 'event_espresso'), |
|
| 263 | + $singular_name |
|
| 264 | + ), |
|
| 265 | + 'search_items' => sprintf( |
|
| 266 | + /* Translators: Post Type Label */ |
|
| 267 | + esc_html_x('Search %s', 'Search Events', 'event_espresso'), |
|
| 268 | + $plural_name |
|
| 269 | + ), |
|
| 270 | + 'not_found' => sprintf( |
|
| 271 | + /* Translators: Post Type Label */ |
|
| 272 | + esc_html_x('No %s found', 'No Events found', 'event_espresso'), |
|
| 273 | + $plural_name |
|
| 274 | + ), |
|
| 275 | + 'not_found_in_trash' => sprintf( |
|
| 276 | + /* Translators: Post Type Label */ |
|
| 277 | + esc_html_x('No %s found in Trash', 'No Events found in Trash', 'event_espresso'), |
|
| 278 | + $plural_name |
|
| 279 | + ), |
|
| 280 | + 'parent_item_colon' => '', |
|
| 281 | + 'menu_name' => $plural_name, |
|
| 282 | + ); |
|
| 283 | + } |
|
| 284 | 284 | |
| 285 | 285 | |
| 286 | - /** |
|
| 287 | - * @param array $labels |
|
| 288 | - * @param string $post_type |
|
| 289 | - * @param string $plural_slug |
|
| 290 | - * @return array |
|
| 291 | - */ |
|
| 292 | - private function getDefaultArguments(array $labels, $post_type, $plural_slug) |
|
| 293 | - { |
|
| 294 | - return array( |
|
| 295 | - 'labels' => $labels, |
|
| 296 | - 'public' => true, |
|
| 297 | - 'publicly_queryable' => true, |
|
| 298 | - 'show_ui' => false, |
|
| 299 | - 'show_ee_ui' => true, |
|
| 300 | - 'show_in_menu' => false, |
|
| 301 | - 'show_in_nav_menus' => false, |
|
| 302 | - 'query_var' => true, |
|
| 303 | - 'rewrite' => apply_filters( |
|
| 304 | - 'FHEE__EventEspresso_core_domain_entities_custom_post_types_RegisterCustomPostTypes__getDefaultArguments__rewrite', |
|
| 305 | - // legacy filter applied for now, |
|
| 306 | - // later on we'll run a has_filter($tag) check and throw a doing_it_wrong() notice |
|
| 307 | - apply_filters( |
|
| 308 | - 'FHEE__EE_Register_CPTs__register_CPT__rewrite', |
|
| 309 | - array('slug' => $plural_slug), |
|
| 310 | - $post_type |
|
| 311 | - ), |
|
| 312 | - $post_type, |
|
| 313 | - $plural_slug |
|
| 314 | - ), |
|
| 315 | - 'capability_type' => 'post', |
|
| 316 | - 'map_meta_cap' => true, |
|
| 317 | - 'has_archive' => true, |
|
| 318 | - 'hierarchical' => false, |
|
| 319 | - 'menu_position' => null, |
|
| 320 | - 'supports' => array( |
|
| 321 | - 'title', |
|
| 322 | - 'editor', |
|
| 323 | - 'author', |
|
| 324 | - 'thumbnail', |
|
| 325 | - 'excerpt', |
|
| 326 | - 'custom-fields', |
|
| 327 | - 'comments', |
|
| 328 | - ), |
|
| 329 | - ); |
|
| 330 | - } |
|
| 286 | + /** |
|
| 287 | + * @param array $labels |
|
| 288 | + * @param string $post_type |
|
| 289 | + * @param string $plural_slug |
|
| 290 | + * @return array |
|
| 291 | + */ |
|
| 292 | + private function getDefaultArguments(array $labels, $post_type, $plural_slug) |
|
| 293 | + { |
|
| 294 | + return array( |
|
| 295 | + 'labels' => $labels, |
|
| 296 | + 'public' => true, |
|
| 297 | + 'publicly_queryable' => true, |
|
| 298 | + 'show_ui' => false, |
|
| 299 | + 'show_ee_ui' => true, |
|
| 300 | + 'show_in_menu' => false, |
|
| 301 | + 'show_in_nav_menus' => false, |
|
| 302 | + 'query_var' => true, |
|
| 303 | + 'rewrite' => apply_filters( |
|
| 304 | + 'FHEE__EventEspresso_core_domain_entities_custom_post_types_RegisterCustomPostTypes__getDefaultArguments__rewrite', |
|
| 305 | + // legacy filter applied for now, |
|
| 306 | + // later on we'll run a has_filter($tag) check and throw a doing_it_wrong() notice |
|
| 307 | + apply_filters( |
|
| 308 | + 'FHEE__EE_Register_CPTs__register_CPT__rewrite', |
|
| 309 | + array('slug' => $plural_slug), |
|
| 310 | + $post_type |
|
| 311 | + ), |
|
| 312 | + $post_type, |
|
| 313 | + $plural_slug |
|
| 314 | + ), |
|
| 315 | + 'capability_type' => 'post', |
|
| 316 | + 'map_meta_cap' => true, |
|
| 317 | + 'has_archive' => true, |
|
| 318 | + 'hierarchical' => false, |
|
| 319 | + 'menu_position' => null, |
|
| 320 | + 'supports' => array( |
|
| 321 | + 'title', |
|
| 322 | + 'editor', |
|
| 323 | + 'author', |
|
| 324 | + 'thumbnail', |
|
| 325 | + 'excerpt', |
|
| 326 | + 'custom-fields', |
|
| 327 | + 'comments', |
|
| 328 | + ), |
|
| 329 | + ); |
|
| 330 | + } |
|
| 331 | 331 | } |
@@ -16,26 +16,26 @@ |
||
| 16 | 16 | class InvalidCollectionIdentifierException extends OutOfBoundsException |
| 17 | 17 | { |
| 18 | 18 | |
| 19 | - /** |
|
| 20 | - * InvalidCollectionIdentifierException constructor. |
|
| 21 | - * |
|
| 22 | - * @param $identifier |
|
| 23 | - * @param string $message |
|
| 24 | - * @param int $code |
|
| 25 | - * @param Exception|null $previous |
|
| 26 | - */ |
|
| 27 | - public function __construct($identifier, $message = '', $code = 0, Exception $previous = null) |
|
| 28 | - { |
|
| 29 | - if (empty($message)) { |
|
| 30 | - $message = sprintf( |
|
| 31 | - __( |
|
| 32 | - 'The supplied identifier "%1$s" does not exist within this collection. |
|
| 19 | + /** |
|
| 20 | + * InvalidCollectionIdentifierException constructor. |
|
| 21 | + * |
|
| 22 | + * @param $identifier |
|
| 23 | + * @param string $message |
|
| 24 | + * @param int $code |
|
| 25 | + * @param Exception|null $previous |
|
| 26 | + */ |
|
| 27 | + public function __construct($identifier, $message = '', $code = 0, Exception $previous = null) |
|
| 28 | + { |
|
| 29 | + if (empty($message)) { |
|
| 30 | + $message = sprintf( |
|
| 31 | + __( |
|
| 32 | + 'The supplied identifier "%1$s" does not exist within this collection. |
|
| 33 | 33 | You may need to delay adding this asset until the required dependency has been added.', |
| 34 | - 'event_espresso' |
|
| 35 | - ), |
|
| 36 | - $identifier |
|
| 37 | - ); |
|
| 38 | - } |
|
| 39 | - parent::__construct($message, $code, $previous); |
|
| 40 | - } |
|
| 34 | + 'event_espresso' |
|
| 35 | + ), |
|
| 36 | + $identifier |
|
| 37 | + ); |
|
| 38 | + } |
|
| 39 | + parent::__construct($message, $code, $previous); |
|
| 40 | + } |
|
| 41 | 41 | } |
@@ -16,25 +16,25 @@ |
||
| 16 | 16 | class DuplicateCollectionIdentifierException extends OutOfRangeException |
| 17 | 17 | { |
| 18 | 18 | |
| 19 | - /** |
|
| 20 | - * DuplicateCollectionIdentifierException constructor. |
|
| 21 | - * |
|
| 22 | - * @param $identifier |
|
| 23 | - * @param string $message |
|
| 24 | - * @param int $code |
|
| 25 | - * @param Exception|null $previous |
|
| 26 | - */ |
|
| 27 | - public function __construct($identifier, $message = '', $code = 0, Exception $previous = null) |
|
| 28 | - { |
|
| 29 | - if (empty($message)) { |
|
| 30 | - $message = sprintf( |
|
| 31 | - __( |
|
| 32 | - 'The supplied identifier "%1$s" already exists within this collection.', |
|
| 33 | - 'event_espresso' |
|
| 34 | - ), |
|
| 35 | - $identifier |
|
| 36 | - ); |
|
| 37 | - } |
|
| 38 | - parent::__construct($message, $code, $previous); |
|
| 39 | - } |
|
| 19 | + /** |
|
| 20 | + * DuplicateCollectionIdentifierException constructor. |
|
| 21 | + * |
|
| 22 | + * @param $identifier |
|
| 23 | + * @param string $message |
|
| 24 | + * @param int $code |
|
| 25 | + * @param Exception|null $previous |
|
| 26 | + */ |
|
| 27 | + public function __construct($identifier, $message = '', $code = 0, Exception $previous = null) |
|
| 28 | + { |
|
| 29 | + if (empty($message)) { |
|
| 30 | + $message = sprintf( |
|
| 31 | + __( |
|
| 32 | + 'The supplied identifier "%1$s" already exists within this collection.', |
|
| 33 | + 'event_espresso' |
|
| 34 | + ), |
|
| 35 | + $identifier |
|
| 36 | + ); |
|
| 37 | + } |
|
| 38 | + parent::__construct($message, $code, $previous); |
|
| 39 | + } |
|
| 40 | 40 | } |