• File: class-fusion-builder-animation-helper.php
  • Full Path: /home/docteuh/www/plugins/fusion-builder/inc/helpers/class-fusion-builder-animation-helper.php
  • Date Modified: 11/20/2023 6:12 PM
  • File size: 6.93 KB
  • MIME-type: text/x-php
  • Charset: utf-8
<?php
/**
 * Avada Builder Animation Helper class.
 *
 * @package Avada-Builder
 * @since 2.2
 */

// Do not allow directly accessing this file.
if ( ! defined( 'ABSPATH' ) ) {
	exit( 'Direct script access denied.' );
}

/**
 * Avada Builder Animation Helper class.
 *
 * @since 2.2
 */
class Fusion_Builder_Animation_Helper {

	/**
	 * Class constructor.
	 *
	 * @since 2.2
	 * @access public
	 */
	public function __construct() {
	}

	/**
	 * Get animation params.
	 *
	 * @since 2.2
	 * @access public
	 * @param array $args The placeholder arguments.
	 * @return array
	 */
	public static function get_params( $args ) {

		$selector = isset( $args['preview_selector'] ) ? $args['preview_selector'] : '';

		$animation_type_setting = [
			'type'        => 'select',
			'heading'     => esc_attr__( 'Animation Type', 'fusion-builder' ),
			'description' => esc_attr__( 'Select the type of animation to use on the element.', 'fusion-builder' ),
			'param_name'  => 'animation_type',
			'value'       => fusion_builder_available_animations(),
			'default'     => '',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'preview'     => [
				'selector' => $selector,
				'type'     => 'animation',
			],
		];

		$animation_direction_setting = [
			'type'        => 'radio_button_set',
			'heading'     => esc_attr__( 'Direction of Animation', 'fusion-builder' ),
			'description' => esc_attr__( 'Select the incoming direction for the animation.', 'fusion-builder' ),
			'param_name'  => 'animation_direction',
			'default'     => 'left',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'dependency'  => [
				[
					'element'  => 'animation_type',
					'value'    => '',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'flash',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'shake',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'rubberband',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'flipinx',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'flipiny',
					'operator' => '!=',
				],
				[
					'element'  => 'animation_type',
					'value'    => 'lightspeedin',
					'operator' => '!=',
				],
			],
			'value'       => [
				'down'   => esc_attr__( 'Top', 'fusion-builder' ),
				'right'  => esc_attr__( 'Right', 'fusion-builder' ),
				'up'     => esc_attr__( 'Bottom', 'fusion-builder' ),
				'left'   => esc_attr__( 'Left', 'fusion-builder' ),
				'static' => esc_attr__( 'Static', 'fusion-builder' ),
			],
			'preview'     => [
				'selector' => $selector,
				'type'     => 'animation',
			],
		];

		$animation_color_setting = [
			'type'        => 'colorpickeralpha',
			'heading'     => esc_attr__( 'Animation Color', 'fusion-builder' ),
			'description' => esc_attr__( 'Select the color of the animation', 'fusion-builder' ),
			'param_name'  => 'animation_color',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'default'     => 'var(--primary_color)',
			'dependency'  => [
				[
					'element'  => 'animation_type',
					'value'    => 'reveal',
					'operator' => '==',
				],
			],
			'preview'     => [
				'selector' => $selector,
				'type'     => 'animation',
			],
		];

		$animation_speed_setting = [
			'type'        => 'range',
			'heading'     => esc_attr__( 'Speed of Animation', 'fusion-builder' ),
			'description' => esc_attr__( 'Type in speed of animation in seconds (0.1 - 5).', 'fusion-builder' ),
			'param_name'  => 'animation_speed',
			'min'         => '0.1',
			'max'         => '5',
			'step'        => '0.1',
			'value'       => '0.3',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'dependency'  => [
				[
					'element'  => 'animation_type',
					'value'    => '',
					'operator' => '!=',
				],
			],
			'preview'     => [
				'selector' => $selector,
				'type'     => 'animation',
			],
		];

		$animation_delay_setting = [
			'type'        => 'range',
			'heading'     => esc_attr__( 'Animation Delay', 'fusion-builder' ),
			'description' => esc_attr__( 'Select the delay time after the animation starts(0 - 5).', 'fusion-builder' ),
			'param_name'  => 'animation_delay',
			'min'         => '0',
			'max'         => '5',
			'step'        => '0.1',
			'value'       => '0',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'dependency'  => [
				[
					'element'  => 'animation_type',
					'value'    => '',
					'operator' => '!=',
				],
			],
			'preview'     => [
				'selector' => $selector,
				'type'     => 'animation',
			],
		];

		$animation_offset_setting = [
			'type'        => 'select',
			'heading'     => esc_attr__( 'Offset of Animation', 'fusion-builder' ),
			'description' => esc_attr__( 'Controls when the animation should start.', 'fusion-builder' ),
			'param_name'  => 'animation_offset',
			'default'     => '',
			'group'       => esc_attr__( 'Extras', 'fusion-builder' ),
			'dependency'  => [
				[
					'element'  => 'animation_type',
					'value'    => '',
					'operator' => '!=',
				],
			],
			'value'       => [
				''                => esc_attr__( 'Default', 'fusion-builder' ),
				'top-into-view'   => esc_attr__( 'Top of element hits bottom of viewport', 'fusion-builder' ),
				'top-mid-of-view' => esc_attr__( 'Top of element hits middle of viewport', 'fusion-builder' ),
				'bottom-in-view'  => esc_attr__( 'Bottom of element enters viewport', 'fusion-builder' ),
			],
		];

		$return_settings = [];
		array_push( $return_settings, $animation_type_setting, $animation_direction_setting, $animation_color_setting, $animation_speed_setting );

		if ( ! isset( $args['remove_delay_option'] ) || ! $args['remove_delay_option'] ) {
			array_push( $return_settings, $animation_delay_setting );
		}

		array_push( $return_settings, $animation_offset_setting );

		return $return_settings;
	}

	/**
	 * Add animation attributes.
	 *
	 * @since 2.2
	 * @param array   $args   Element arguments.
	 * @param array   $attr   Element attributes.
	 * @param boolean $parent Is parent.
	 * @return array
	 */
	public static function add_animation_attributes( $args = [], $attr = [], $parent = false ) {

		$animations = FusionBuilder::animations(
			[
				'type'      => $args['animation_type'],
				'direction' => $args['animation_direction'],
				'speed'     => $args['animation_speed'],
				'delay'     => isset( $args['animation_delay'] ) ? $args['animation_delay'] : '',
				'offset'    => $args['animation_offset'],
			]
		);

		$attr = array_merge( $attr, $animations );

		if ( false === $parent ) {
			$attr['class'] .= ' ' . $attr['animation_class'];
		}
		unset( $attr['animation_class'] );

		if ( isset( $args['animation_color'] ) && $args['animation_color'] && 'reveal' === $args['animation_type'] ) {
			if ( ! isset( $attr['style'] ) ) {
				$attr['style'] = '';
			}
			$attr['style'] .= '--awb-animation-color:' . $args['animation_color'] . ';';
		}

		return $attr;
	}
}