Merge pull request #9 from SolidDigital/feature/display-conditions

add display conditions

Author: pajtai

classes/display-condition-solid-dynamics-macro.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Solid;
+
+class DisplayConditionSolidDynamicsMacro extends \ElementorPro\Modules\DisplayConditions\Conditions\Base\Condition_Base {
+    public function get_name() {
+        return 'solid_dynamics_macro';
+    }
+
+    public function get_label() {
+        return esc_html__( 'Solid Dynamics Macro', 'solid-dynamics' );
+    }
+
+    public function get_group() {
+        return 'other';
+    }
+
+    public function check( $args ) : bool {
+        $value = solid_dynamics_macro($args['macro']);
+        return boolval($value);
+    }
+
+    public function get_options() {
+        $this->add_control(
+            'macro',
+            [
+                'label' => __( 'Macro', 'solid-dynamics' ),
+                'type' => \Elementor\Controls_Manager::TEXT,
+            ]
+        );
+    }
+}
+
+function solid_dynamics_macro($macro) {
+    $items = explode('|', $macro);
+    $type = $items[0] ?? '';
+    $field = $items[1] ?? '';
+
+    // TODO: add index for repeater fields.
+    // $index = $items[2];
+
+    if (empty($type) || empty($field)) {
+        return;
+    }
+
+    switch ($type) {
+        case 'post':
+            global $post;
+
+            if ($post->$field !== null) {
+                return $post->$field;
+            }
+
+            return get_post_meta($post->ID, $field, true);
+        case 'user':
+            $user = wp_get_current_user();
+
+            if ($user->$field !== null) {
+                return $user->$field;
+            }
+
+            return get_user_meta($user->ID, $field, true);
+
+        case 'function':
+            if (is_callable($field)) {
+                return $field();
+            };
+
+            return;
+        // TODO: add option
+        // case 'option':
+        //     $option = get_option($field);
+        //     return $option;
+        // TODO: add author
+        // case 'author':
+        //     $author = get_queried_object();
+        //     return $author->name;
+        // TODO: add term
+        // case 'term':
+        //     $term = get_queried_object();
+        //     return $term->name;
+    }
+}

classes/elementor-display-conditions.php

@@ -0,0 +1,14 @@
+<?php
+namespace Solid;
+
+class ElementorDisplayConditions {
+    function __construct() {
+        add_action( 'elementor/display_conditions/register', [$this, 'elementor_display_conditions_register_conditions'] );
+    }
+
+    function elementor_display_conditions_register_conditions($conditions_manager) {
+        require_once( __DIR__ . "/display-condition-solid-dynamics-macro.php" );
+
+        $conditions_manager->register_condition_instance( new DisplayConditionSolidDynamicsMacro() );
+    }
+}

classes/post-field.php

@@ -26,7 +26,7 @@ protected function _register_controls() {
         $this->add_control(
             'fieldname',
             [
-                'label' => __( 'Callback', 'solid-dynamics' ),
+                'label' => __( 'Post Field', 'solid-dynamics' ),
                 'type' => \Elementor\Controls_Manager::TEXT,
             ]
         );

readme.txt

@@ -10,7 +10,11 @@ Helpful utilities for Elementor, Jet Engine, and beyond.
 
 == Description ==
 
-This plugin provides an Admin Page called, "Widget Usage" under the "Solid Dynamics" menu that shows the individual posts in which a widget is used. Currently, the Elementor Element Manager only shows the total number of usages of a widget. We're always wondering where those widgets are being used, and "Widget Usage" is the answer to that question.
+Elementor Widget Usage
+
+Solid Dynamics provides an Admin Page called, "Widget Usage" under the "Solid Dynamics" menu that shows the individual posts in which a widget is used. Currently, the Elementor Element Manager only shows the total number of usages of a widget. We're always wondering where those widgets are being used, and "Widget Usage" is the answer to that question.
+
+Elementor Dynamic Tags
 
 Solid Dynamics also provides several dynamic tags under the "Solid Dynamics" section in Elementor:
 
@@ -20,7 +24,15 @@ Solid Dynamics also provides several dynamic tags under the "Solid Dynamics" sec
 - `List Pluck`: Pluck `field` off each item in `list` (`src` meta or option), and join with `sep`.
 - `Post Field`: Retrieves custom post field by name.
 
-This plugin also provides several general use and Elementor specific settings under the menu Solid Dynamics. All settings have to be opted in to. Activating the plugin does not activate any of the settings. Activating the plugin does automatically make the dynamic tags listed above available.
+Elementor Display Conditions
+
+Solid Dynamics also provides several display conditions for Elementor:
+
+- `Solid Dynamics Macro`: access post or user data, e.g. `post|post_content`, `user|user_email`, or call any function `function|get_current_user_id`. The result is passed to boolval to show the widget.
+
+Settings
+
+Solid Dynamics also provides several general use and Elementor specific settings under the menu Solid Dynamics. All settings have to be opted in to. Activating the plugin does not activate any of the settings. Activating the plugin does automatically make the dynamic tags listed above available.
 
 General Settings:
 

solid-dynamics.php

@@ -18,6 +18,10 @@
 	die;
 }
 
+require_once( __DIR__ . "/classes/elementor-display-conditions.php" );
+
+new ElementorDisplayConditions();
+
 require_once( __DIR__ . "/classes/elementor-dynamic-tags.php" );
 
 new ElementorDynamicTags();