Emma Feed Meta

Introduction

The Feed Meta object for the Emma Add-On is an associative array containing the properties which determine how the add-on should process the form submission.

1
2
3
4
5
6
7
8
9
$feed['meta'] = array(
    'feed_name'                               => 'Your Feed Name',
    'email_address'                           => '2',
    'custom_fields'                           => array(),
    'feed_condition_conditional_logic'        => true,
    'feed_condition_conditional_logic_object' => array(
        'conditionalLogic' => array(),
    ),
);

Usage

We recommend accessing the $feed meta using the rgar() or rgars() functions, e.g.:

1
2
3
4
5
6
7
8
9
10
11
12
13
$conditional_logic_enabled = rgars( $feed, 'meta/feedCondition' );
 
if ( $conditional_logic_enabled ) {
    // Conditional logic is enabled for this feed.
    $logic_rules = rgars( $feed, 'meta/feed_condition_conditional_logic_object/conditionalLogic/rules' );
    foreach ( $logic_rules as $rule ) {
        // Process each conditional logic rule.
        $field_id  = rgar( $rule, 'fieldId' );
        $operator  = rgar( $rule, 'operator' );
        $value     = rgar( $rule, 'value' );
        // Example: Use $field_id, $operator, and $value in your logic.
    }
}

Properties

  • feed_name string

    The feed name which appears on the add-ons feeds tab.

  • group string

    The Emma Group ID this feed will add the member to.

  • email_address string

    The ID of the form field containing the member email.

  • custom_fields array

    A multidimensional array containing the Emma contact fields. See Custom Field Properties.

  • double_optin boolean

    Should Emma send a confirmation email to the member. Default is false.

  • feed_condition_conditional_logic boolean

    Is the feed condition (conditional logic) setting enabled. Default is false.

  • feed_condition_conditional_logic_object array

    An associative array containing the conditional logic rules. See the Conditional Logic Object for more details.

Custom Field Properties

1
2
3
4
array(
    'key'   => 'address-full',
    'value' => '3',
)

Each custom field is an associative array containing the following properties:

  • key string

    The Emma contact fields Shortcut name.

  • value stringThe ID of the form field or entry meta item containing the value for this custom field.