# depicter/trunk/app/src/Document/Helper/Helper.php

Depicter — Popup & Slider Builder, version trunk. 368 lines.

- Page: https://pluginprobe.com/plugins/depicter/trunk/code/app/src/Document/Helper/Helper.php
- Raw: https://pluginprobe.com/plugins/depicter/trunk/raw/app/src/Document/Helper/Helper.php
- Modified: 2026-08-15T09:50:06+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/depicter/trunk/code/app/src/Document/Helper/Helper.php#L10-L20`.

```php
<?php
namespace Depicter\Document\Helper;


use Averta\WordPress\Utility\JSON;
use Depicter\Document\CSS\Breakpoints;
use Depicter\Document\CSS\Selector;

class Helper
{
	/**
	 * Generate data-actions value for DOM
	 *
	 * @param array $actions
	 *
	 * @return string
	 */
	public static function getActions( $actions ) {
		if ( !is_array( $actions ) || empty( $actions ) ) {
			return '';
		}

		$output = [];
		foreach ( $actions as $key =>  $action ) {
			$action = (array) $action;

			$action_params = [];
			$action_params[] = $action['type'];
			$action_params[] = $action['trigger'];
			$action_params[] = (int) ! empty( $action['delay'] ) ? $action['delay'] : 0;

			if( !empty( $action['options'] ) ){
				if ( $action['type'] == 'customJS' ) {
					$customJS = $action['options']->value;
					$action['options']->value = $key;
				}

				if ( $action['type'] == 'openURL' ) {
					$action['options']->path = esc_url( $action['options']->path );
				}

				$action_params[] = clone $action['options'];

				if ( $action['type'] == 'customJS' ) {
					$action['options']->value = $customJS;
				}
				 
			}

			$output[] = $action_params;
		}

		return JSON::encode( $output );
	}


	/**
	 * Extract section ID from slug
	 *
	 * @param string $sectionSlug
	 *
	 * @return string
	 */
	public static function getSectionIdFromSlug( $sectionSlug = '' ){
		return ltrim( $sectionSlug, Selector::SECTION_PREFIX . '-' );
	}

	/**
	 * Extract element ID from slug
	 *
	 * @param string $elementSlug
	 *
	 * @return string
	 */
	public static function getElementIdFromSlug( $elementSlug = '' ){
		return ltrim( $elementSlug, Selector::ELEMENT_PREFIX . '-' );
	}

	public static function getSectionCssId( $documentId, $sectionId ){
		return Selector::getFullSelectorPath( $documentId, $sectionId );
	}

	public static function sectionsSlugsListToCssIDsList( $sectionsSlugList, $documentId ){

		if( empty( $sectionsSlugList ) || ! is_array( $sectionsSlugList ) ){
			return [];
		}

		$sectionsCssIDsList = [];

		foreach( $sectionsSlugList as $sectionSlug ){
			$sectionIdNumber = self::getSectionIdFromSlug( $sectionSlug );
			$sectionsCssIDsList[] = self::getSectionCssId( $documentId, $sectionIdNumber );
		}

		return $sectionsCssIDsList;
	}

	/**
	 * extract third party and selfhosted asset IDs from document content
	 * @param $content
	 * @param bool $includeNumericalIds // get selfhosted asset IDs with numerical values
	 *
	 * @return array|void
	 */
	public static function extractAssetIds( $content, $includeNumericalIds = false) {

		if ( empty( $content ) ) {
			return;
		}

		$assetIDs = [];

		$patterns = [
			'"source":"([^"]*)"',
			'"src":"([^"]*)"',
			'"src":{([^}]+)}'
		];

		foreach ( $patterns as $pattern ) {
			preg_match_all( '/' . $pattern . '/', $content, $sources , PREG_SET_ORDER );
			if ( !empty( $sources ) ) {
				foreach ( $sources as $source ) {
					// check if assetID if for third party libraries or not
					if ($includeNumericalIds && !empty( $source[1] ) && false === strpos( $source[1], 'https' ) && is_numeric($source[1])) {
						$assetIDs[] = $source[1];
					} else if ( !empty( $source[1] ) && strpos( $source[1], '@') === 0 && false === strpos( $source[1], 'https' ) ) {
						$assetIDs[] = $source[1];
					}
					
					if ( !empty( $source[1] ) ) {
						$backgroundPatterns = ':"([^"]*)"';
						preg_match_all( '/' . $backgroundPatterns . '/', $source[1], $backgroundSources , PREG_SET_ORDER );
						if ( !empty( $backgroundSources ) ) {
							foreach ( $backgroundSources as $backgroundSource ) {
								if ($includeNumericalIds && !empty( $backgroundSource[1] ) && false === strpos( $backgroundSource[1], 'https' ) && is_numeric($backgroundSource[1])) {
									$assetIDs[] = $backgroundSource[1];
								} else if ( !empty( $backgroundSource[1] ) && strpos( $backgroundSource[1], '@') === 0 && false === strpos( $backgroundSource[1], 'https' ) ) {
									$assetIDs[] = $backgroundSource[1];
								}
							}
						}
					}
				}
			}
		}

		return $assetIDs;
	}


	/**
	 * Get list of class which has specific elementId
	 *
	 * @param       $hideOnSections
	 * @param int   $documentId
	 * @param array $allSections
	 *
	 * @return string
	 */
	public static function getVisibleSectionsCssIdList( $hideOnSections, $documentId, $allSections = [] ) {

		if ( ! empty( $hideOnSections ) ) {
			foreach ( $allSections as $key => $section ) {
				if ( in_array( $section, $hideOnSections ) ) {
					unset( $allSections[ $key ] );
				}
			}
		}

		return implode( ',', Helper::sectionsSlugsListToCssIDsList( $allSections, $documentId ) );
	}

	/**
	 * Get list of class which has specific elementId
	 *
	 * @param       $hideOnSections
	 * @param       $documentId
	 *
	 * @return string
	 */
	public static function getInvisibleSectionsCssIdList( $hideOnSections, $documentId ) {
		if( !empty( $hideOnSections ) ){
			return implode( ',', Helper::sectionsSlugsListToCssIDsList( $hideOnSections, $documentId ) );
		}
		return '';
	}

	/**
	 * Get parent device value for a css variable
	 *
	 * @param $cssVariableInstance
	 * @param $variable
	 * @param $device
	 * @param $default
	 *
	 * @return mixed
	 */
	public static function getParentValue( $cssVariableInstance, $variable, $device, $default ) {
		$parentDevice = Breakpoints::getParentDevice( $device );
		if ( !empty( $parentDevice ) ) {

			if ( strpos( $variable, 'enable' ) === false ) {
				return $cssVariableInstance->{$parentDevice}->{$variable} ?? self::getParentValue( $cssVariableInstance, $variable, $parentDevice, $default );
			} else {
				return $cssVariableInstance->{$parentDevice}->{$variable} ?? true;
			}

		}

		return $default;
	}

	/**
	 * Check if style is enabled for specific device or not
	 *
	 * @param $cssVariableInstance
	 * @param string $device
	 * @param string $enabledParam
	 * @return boolean
	 */
	public static function isStyleEnabled( $cssVariableInstance, $device, $enableParam = 'enable' ) {
		if ( $device == 'default' ) {
			return isset( $cssVariableInstance->default->{$enableParam} ) ? !empty( $cssVariableInstance->default->{$enableParam} ) : !empty( $cssVariableInstance->default ) ;
		}

		return $cssVariableInstance->{$device}->{$enableParam} ?? self::getParentValue( $cssVariableInstance, $enableParam, $device, true );
	}

	/**
	 * Check if hover style is enable for specific device
	 *
	 * @param $hoverInstance
	 * @param string $device
	 * @return boolean
	 */
	public static function isHoverStyleEnabled( $hoverInstance, $device ) {
		if ( $device == 'default' ) {
			return !empty( $hoverInstance->enable->{$device} );
		}

		$parentDevice = Breakpoints::getParentDevice( $device );
		return $hoverInstance->enable->{$device} ?? self::isHoverStyleEnabled( $hoverInstance, $parentDevice );
	}

	/**
	 * Get triggers from display rule meta for a document ID
	 *
	 * @param $documentID
	 *
	 * @return array
	 */
	 public static function getDisplayRuleTriggers( $documentID ): array{

		 $rule = \Depicter::metaRepository()->get( $documentID, 'rules', '' );
		 $displayRule = JSON::isJson( $rule ) ? JSON::decode( $rule, true ) : [];

		 if ( empty( $displayRule['triggers'] ) ) {
			 return [];
		 }

		 $triggersList = array_filter( $displayRule['triggers'], function ( $triggerObject ) {
			 return $triggerObject['enable'];
		 });

		 return array_values( $triggersList );
	 }

	/**
	 * Get display again properties
	 *
	 * @param $documentID
	 *
	 * @return array
	 */
	 public static function getDisplayAgainProperties( $documentID ) {
		 $rule = \Depicter::metaRepository()->get( $documentID, 'rules', '' );
		 $displayRule = JSON::isJson( $rule ) ? JSON::decode( $rule, true ) : [];

		 if ( empty( $displayRule ) || empty( $displayRule['afterClose'] ) ) {
			 return [];
		 }

		 if ( $displayRule['afterClose']['displayAgain'] == 'afterPeriod' ) {
			 $periodType = $displayRule['afterClose']['displayAgainPeriodType'];
			 switch( $periodType ) {
				 case 's':
					 $period = $displayRule['afterClose']['displayAgainPeriod'] / 60;
					 break;
				 case 'h':
					 $period = $displayRule['afterClose']['displayAgainPeriod'] * 60;
					 break;
				 case 'd':
					 $period = $displayRule['afterClose']['displayAgainPeriod'] * 24 * 60;
					 break;
				 default:
					 // minutes
					 $period = $displayRule['afterClose']['displayAgainPeriod'];
					 break;
			 }

			 return [
				 'displayAgain' => 'afterPeriod',
				 'displayAgainPeriod' => $period
			 ];
		 }

		 return [
			 'displayAgain' => $displayRule['afterClose']['displayAgain']
		 ];
	 }

    /**
     * change a string from camelCase style to hyphenated style
     * @param $inputString
     *
     * @return string
     */
    public static function camelCaseToHyphenated( $inputString ): string
    {
        $inputString = strtolower(preg_replace('/(?<!^)[A-Z]/', '-$0', $inputString));
		// Some times the second part of original hyphenated text that converted to camel case starts with numbber so when converting it back the hyphen character missed and we need to add it again here
		if (strpos($inputString, 'depicter') !== false && strpos($inputString, 'depicter-') === false ) {
			$inputString = str_replace('depicter', 'depicter-', $inputString);
		}

		return $inputString;
    }

	/**
     * change a string from camelCase style to snake case style
     * @param $inputString
     *
     * @return string
     */
    public static function camelCaseToSnakeCase( $inputString ): string
    {
        $inputString = strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $inputString));
		// Some times the second part of original hyphenated text that converted to camel case starts with numbber so when converting it back the underline character missed and we need to add it again here
		if (strpos($inputString, 'depicter') !== false && strpos($inputString, 'depicter_') === false ) {
			$inputString = str_replace('depicter', 'depicter_', $inputString);
		}

		return $inputString;
    }

	/**
	 * Return label for a document type
	 * 
	 */
	public static function getDocumentTypeLabel( string $type ): string
	{
		$typesDictionary = [
			'slider'      => __( 'Slider', 'depicter' ),
			'custom'      => __( 'Slider', 'depicter' ),
			'popup'       => __( 'Popup', 'depicter' ),
			'post-slider' => __( 'Post Slider', 'depicter' ),
			'woo-slider'  => __( 'Product Slider', 'depicter' ),
			'banner-bar'  => __( 'Notification Bar', 'depicter' ),
			'carousel'    => __( 'Carousel', 'depicter' ),
			'hero-section'=> __( 'Hero Section', 'depicter' ),
			'survey'	  => __( 'Survey', 'depicter' )
		];

		return !empty( $typesDictionary[ $type ] ) ? $typesDictionary[ $type ] : __('Slider', 'depicter' );		
	}
}

```