Important:<\/strong> Creating custom rules requires technical knowledge and should be performed by developers or tech-savvy users familiar with PHP and WordPress development.<\/p>\n<\/blockquote>\n\n\n\n Conditional display rules in Thrive Architect consist of two main components:<\/p>\n\n\n\n Example 1:<\/strong> Create a new field called “Page \u2013 Demo” with a subfield “Title \u2013 Demo”, plus add a “Number of comments \u2013 Demo” field to the existing “User” entity.<\/p>\n\n\n\n Example 2:<\/strong> Create a rule that checks whether a user has specific WP Fusion tags assigned to them.<\/p>\n\n\n\n Note:<\/strong> You can find a complete demo example on GitHub: Conditional Display API Demo<\/a><\/p>\n<\/blockquote>\n\n\n\n Once activated, your custom fields will appear in the conditional display popup in Thrive Architect:<\/p>\n\n\n\n The first step is to define an entity class that describes your subject and its properties.<\/p>\n\n\n\n Create a class that extends The The This label will appear inside the Thrive Architect editor.<\/p>\n\n\n\n The Determine the display order in the modal entity select:<\/p>\n\n\n\n After defining your entity class, you need to register it using the Use your entity class as the parameter when calling this function.<\/p>\n\n\n\n Here’s what your complete entity class looks like when everything is put together:<\/p>\n\n\n\n Entity fields fetch the specific data that your condition will be tested against.<\/p>\n\n\n\n Create a class that extends The The This label appears inside the visual editor.<\/p>\n\n\n\n The Here are the possible operator\/condition keys you can use:<\/p>\n\n\n\nWhat You’ll Learn<\/h2>\n\n\n\n
\n
\n\n\n\nUnderstanding the Basics<\/h2>\n\n\n\n
\n
Real-World Examples<\/h3>\n\n\n\n
\n
![\"\"](\"https:\/\/mlpxhq8ztvyc.i.optimole.com\/cb:p0Z2.44bbf\/w:auto\/h:auto\/q:mauto\/f:best\/https:\/\/thrivethemes.com\/wp-content\/uploads\/2024\/03\/155287317-6266c41f-3312-4398-871b-9e74ae3f6ca3.webp\")
<\/figure>\n\n\n\n
\n\n\n\nDefining the Entity Class<\/h2>\n\n\n\n
Step 1: Extend the Base Entity Class<\/h3>\n\n\n\n
TCBConditionalDisplayEntity<\/code>:<\/p>\n\n\n\nclass User extends TCBConditionalDisplayEntity {\n \/**\n * @return string\n *\/\n}<\/code><\/pre>\n\n\n\nStep 2: Define the Unique Key<\/h3>\n\n\n\n
get_key()<\/code> function defines a unique identification key for your entity:<\/p>\n\n\n\npublic static function get_key() {\n return 'user_data';\n}<\/code><\/pre>\n\n\n\nStep 3: Set the Display Label<\/h3>\n\n\n\n
get_label()<\/code> function defines the name that will be visible to users in the visual editor:<\/p>\n\n\n\npublic static function get_label() {\n return esc_html__( 'User', 'thrive-cb' );\n}<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/mlpxhq8ztvyc.i.optimole.com\/cb:p0Z2.44bbf\/w:auto\/h:auto\/q:mauto\/f:best\/https:\/\/thrivethemes.com\/wp-content\/uploads\/2024\/03\/2a9549b1-6b68-42d4-94bb-2a40309c787f.png\")
<\/figure>\n\n\n\nStep 4: Create the Object Method<\/h3>\n\n\n\n
create_object()<\/code> property creates the entity object containing all the data for individual fields when the condition logic runs:<\/p>\n\n\n\npublic function create_object( $param ) {\n $user_id = get_current_user_id();\n return get_userdata( $user_id );\n}<\/code><\/pre>\n\n\n\nStep 5: Set Display Order (Optional)<\/h3>\n\n\n\n
\/**\n * Determines the display order in the modal entity select\n *\n * @return int\n *\/\npublic static function get_display_order() {\n return 0;\n}<\/code><\/pre>\n\n\n\n
\n\n\n\nRegistering Your Entity<\/h2>\n\n\n\n
tve_register_condition_entity<\/code> function.<\/p>\n\n\n\nRegistration Function<\/h3>\n\n\n\n
function tve_register_condition_entity( $entity ) {\n TCBConditionalDisplayEntity::register( $entity );\n}<\/code><\/pre>\n\n\n\nComplete Entity Class Example<\/h3>\n\n\n\n
class User extends TCBConditionalDisplayEntity {\n \/**\n * @return string\n *\/\n public static function get_key() {\n return 'user_data';\n }\n\n public static function get_label() {\n return esc_html__( 'User', 'thrive-cb' );\n }\n\n public function create_object( $param ) {\n $user_id = get_current_user_id();\n return get_userdata( $user_id );\n }\n\n \/**\n * Determines the display order in the modal entity select\n *\n * @return int\n *\/\n public static function get_display_order() {\n return 0;\n }\n}<\/code><\/pre>\n\n\n\n
\n\n\n\nCreating Entity Fields<\/h2>\n\n\n\n
Example in the Visual Editor<\/h3>\n\n\n\n
![\"\"](\"https:\/\/mlpxhq8ztvyc.i.optimole.com\/cb:p0Z2.44bbf\/w:auto\/h:auto\/q:mauto\/f:best\/https:\/\/thrivethemes.com\/wp-content\/uploads\/2024\/03\/a0612a72-0bfd-4954-ae2f-42dfb5304a57.png\")
<\/figure>\n\n\n\nStep 1: Extend the Field Class<\/h3>\n\n\n\n
TCBConditionalDisplayField<\/code>:<\/p>\n\n\n\nclass User_Wpfusion_Tags extends TCBConditionalDisplayField {\n \/**\n * @return string\n *\/\n}<\/code><\/pre>\n\n\n\nStep 2: Define the Field Key<\/h3>\n\n\n\n
get_key()<\/code> function defines a unique identification key for the field:<\/p>\n\n\n\npublic static function get_key() {\n return 'user_wpfusion_tags';\n}<\/code><\/pre>\n\n\n\nStep 3: Set the Field Label<\/h3>\n\n\n\n
get_label()<\/code> function defines the name that will be visible to users:<\/p>\n\n\n\npublic static function get_label() {\n return __( 'Has WP Fusion tags', TVE_DASH_TRANSLATE_DOMAIN );\n}<\/code><\/pre>\n\n\n\nStep 4: Define Condition Types<\/h3>\n\n\n\n
get_conditions()<\/code> property describes the type of condition that the field data represents:<\/p>\n\n\n\npublic static function get_conditions() {\n return [ 'autocomplete' ];\n}<\/code><\/pre>\n\n\n\nAvailable Condition Types<\/h4>\n\n\n\n