if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
* Elementor shapes handler class is responsible for setting up the supported
const FILTER_EXCLUDE = 'exclude';
const FILTER_INCLUDE = 'include';
* Holds the list of supported shapes.
* @var array A list of supported shapes.
* Retrieve a shape from the lists of supported shapes. If no shape specified
* it will return all the supported shapes.
* @param array $shape Optional. Specific shape. Default is `null`.
* @return array The specified shape or a list of all the supported shapes.
public static function get_shapes( $shape = null ) {
if ( null === self::$shapes ) {
return isset( self::$shapes[ $shape ] ) ? self::$shapes[ $shape ] : null;
* Retrieve shapes filtered by a specific condition, from the list of
* @param string $by Specific condition to filter by.
* @param string $filter Optional. Comparison condition to filter by.
* @return array A list of filtered shapes.
public static function filter_shapes( $by, $filter = self::FILTER_INCLUDE ) {
self::get_shapes(), function( $shape ) use ( $by, $filter ) {
return self::FILTER_INCLUDE === $filter xor empty( $shape[ $by ] );
* For a given shape, retrieve the file path.
* @param string $shape The shape.
* @param bool $is_negative Optional. Whether the file name is negative or
* not. Default is `false`.
* @return string Shape file path.
public static function get_shape_path( $shape, $is_negative = false ) {
if ( ! isset( self::$shapes[ $shape ] ) ) {
if ( isset( self::$shapes[ $shape ]['path'] ) ) {
$path = self::$shapes[ $shape ]['path'];
return ( $is_negative ) ? str_replace( '.svg', '-negative.svg', $path ) : $path;
$file_name .= '-negative';
return ELEMENTOR_PATH . 'assets/shapes/' . $file_name . '.svg';
* Set the supported shapes.
private static function init_shapes() {
'title' => esc_html_x( 'Mountains', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/mountains.svg',
'title' => esc_html_x( 'Drops', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/drops.svg',
'title' => esc_html_x( 'Clouds', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/clouds.svg',
'title' => esc_html_x( 'Zigzag', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/zigzag.svg',
'title' => esc_html_x( 'Pyramids', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/pyramids.svg',
'title' => esc_html_x( 'Triangle', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/triangle.svg',
'triangle-asymmetrical' => [
'title' => esc_html_x( 'Triangle Asymmetrical', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/triangle-asymmetrical.svg',
'title' => esc_html_x( 'Tilt', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/tilt.svg',
'title' => esc_html_x( 'Tilt Opacity', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/opacity-tilt.svg',
'title' => esc_html_x( 'Fan Opacity', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/opacity-fan.svg',
'title' => esc_html_x( 'Curve', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/curve.svg',
'curve-asymmetrical' => [
'title' => esc_html_x( 'Curve Asymmetrical', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/curve-asymmetrical.svg',
'title' => esc_html_x( 'Waves', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/waves.svg',
'title' => esc_html_x( 'Waves Brush', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/wave-brush.svg',
'title' => esc_html_x( 'Waves Pattern', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/waves-pattern.svg',
'title' => esc_html_x( 'Book', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/book.svg',
'title' => esc_html_x( 'Split', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/split.svg',
'title' => esc_html_x( 'Arrow', 'Shapes', 'elementor' ),
'image' => ELEMENTOR_ASSETS_URL . 'shapes/arrow.svg',
self::$shapes = array_merge( $native_shapes, self::get_additional_shapes() );
* Used to add custom shapes to elementor.
private static function get_additional_shapes() {
static $additional_shapes = null;
if ( null !== $additional_shapes ) {
return $additional_shapes;
* Filters the shapes used by Elementor to add additional shapes.
* @param array $additional_shapes Additional Elementor shapes.
$additional_shapes = apply_filters( 'elementor/shapes/additional_shapes', $additional_shapes );
// BC for addons that add additional shapes the old way using `url` instead of `image`.
foreach ( $additional_shapes as $shape_name => $shape_settings ) {
if ( ! isset( $shape_settings['image'] ) && isset( $shape_settings['url'] ) ) {
$additional_shapes[ $shape_name ]['image'] = $shape_settings['url'];
return $additional_shapes;
* Get Additional Shapes For Config
* Used to set additional shape paths for editor
public static function get_additional_shapes_for_config() {
$additional_shapes = self::get_additional_shapes();
if ( empty( $additional_shapes ) ) {
$additional_shapes_config = [];
foreach ( $additional_shapes as $shape_name => $shape_settings ) {
if ( ! isset( $shape_settings['url'] ) ) {
$additional_shapes_config[ $shape_name ] = $shape_settings['url'];
if ( empty( $additional_shapes_config ) ) {
return $additional_shapes_config;