Overview

Packages

  • ACF
  • Automation
    • Actions
    • Activation
    • LeadProfile
    • Menus
    • Queries
    • Rules
    • Triggers
  • CTA
    • Activation
    • AJAXListeners
    • Cloning
    • Core
    • Display
    • EditPage
    • Enqueues
    • GPLSettings
    • LeadsProfile
    • Loading
    • Menus
    • Notices
    • PlacementMetabox
    • PostType
    • Templates
    • Tracking
    • Variations
    • YOAST
  • InboundPro
    • Activation
    • AdminAJAX
    • AutoLoading
    • Cron
    • DataInterface
    • FieldMapping
    • Funnels
    • InboundNowAPI
    • Installer
    • LeadStatuses
    • Menus
    • Notifications
    • Ouath
    • Reports
    • Settings
    • Tracking
    • Translations
    • Updates
  • LandingPages
    • Activation
    • DataInterfaces
    • Management
    • Menus
    • NeedsAttention
    • Notices
    • Sidebars
    • Templates
    • Tracking
    • Variations
    • WelcomeScreen
    • Widgets
  • Leads
    • Activation
    • Akismet
    • BranchControl
    • BulkActions
    • Dashboard
    • Management
    • Notifications
    • Settings
    • Tracking
    • UserProfile
    • WPLogin
  • Mailer
    • Activation
    • Admin
    • ClickTracking
    • DataInterface
    • InboundForms
    • Leads
    • Management
    • Notifications
    • Scheduling
    • Sending
    • Settings
    • ShortcodesAndTokens
    • SparkPost
    • Templates
    • Unsubscribes
    • Variations
    • YoastSEO
  • None
  • Shared
    • APIs
    • CPT
    • DatabaseRoutines
    • DebugTricks
    • DoubleOptin
    • EventManagement
    • FieldMapping
    • InboundForms
    • LeadSorage
    • MarketingButton
    • Menus
    • Notifications
    • Shortcodes
    • ShortcodesAndTokens
    • StandAloneLicensing
    • Tracking
    • VisualEditor
  • xDepreciated

Classes

  • CTA_Activation
  • CTA_Activation_Update_Routines
  • CTA_Admin_Notices
  • CTA_Ajax_Listeners
  • CTA_Clone_Post
  • CTA_Conversion_Tracking
  • CTA_Dynamic_Widget
  • CTA_Enqueues
  • CTA_Load_Extensions
  • CTA_Menus
  • CTA_Metaboxes
  • CTA_Metaboxes_Global
  • CTA_Post_Type
  • CTA_Render
  • CTA_Settings
  • CTA_Static_Widget
  • CTA_Template_Manager
  • CTA_Template_Manager_List
  • CTA_Variations
  • CTA_WordPress_Leads
  • CTA_WordPress_SEO
  • Inbound_Ajax
  • Inbound_Akismet
  • Inbound_Analytics
  • Inbound_API
  • Inbound_API_Keys_Generation
  • Inbound_API_Keys_Table
  • Inbound_API_Wrapper
  • Inbound_Asset_Loader
  • Inbound_Automation_Action_Add_Remove_List
  • Inbound_Automation_Action_Add_Remove_Tag
  • Inbound_Automation_Action_Create_Lead
  • Inbound_Automation_Action_Create_User
  • Inbound_Automation_Action_Kill_Tasks
  • Inbound_Automation_Action_Relay_Data
  • Inbound_Automation_Action_Send_Email
  • Inbound_Automation_Action_Wait
  • Inbound_Automation_Activation
  • Inbound_Automation_Activation_Update_Routines
  • Inbound_Automation_Adminbar
  • Inbound_Automation_Lead_Profile
  • Inbound_Automation_Loader
  • Inbound_Automation_Plugin
  • Inbound_Automation_Post_Type
  • Inbound_Automation_Processing
  • Inbound_Automation_Query_Lead
  • Inbound_Automation_Query_User
  • Inbound_Automation_Trigger_inbound_double_optin_confirm
  • Inbound_Automation_Trigger_inbound_store_lead_post
  • Inbound_Automation_Trigger_inbound_track_link
  • Inbound_Automation_Trigger_Publish_Post
  • Inbound_Automation_Trigger_Save_Post_Deactivated
  • Inbound_Automation_Trigger_Set_Object_Terms
  • Inbound_Automation_Trigger_Update_Lead
  • Inbound_Automation_Trigger_User_Register
  • Inbound_Calls_To_Action_Plugin
  • Inbound_Confirm_Double_Optin
  • Inbound_Cron
  • Inbound_CTA_Quick_View
  • Inbound_Customizer
  • Inbound_Debug_Scripts
  • Inbound_Email_Meta
  • Inbound_Email_Preview
  • Inbound_Email_Template_Shortcodes
  • Inbound_Event_Report
  • Inbound_Events
  • Inbound_Events_Report
  • Inbound_Extension_Loads
  • Inbound_Forms
  • Inbound_Funnel_Reporting
  • Inbound_Impressions_Report
  • Inbound_Landing_Pages_Plugin
  • Inbound_Lead_Statuses
  • Inbound_Leads
  • Inbound_Leads_Custom_fields
  • Inbound_Leads_Plugin
  • Inbound_License
  • Inbound_List_Double_Optin
  • Inbound_Load_Shared
  • Inbound_Logging_Automation
  • Inbound_Login
  • Inbound_Mail_Daemon
  • Inbound_Mailer_ACF
  • Inbound_Mailer_Activation
  • Inbound_Mailer_Activation_Update_Routines
  • Inbound_Mailer_Ajax_Listeners
  • Inbound_Mailer_Clone_Post
  • Inbound_Mailer_Common_Settings
  • Inbound_Mailer_Customizer
  • Inbound_Mailer_Direct_Email_Leads
  • Inbound_Mailer_Enqueues
  • Inbound_Mailer_Forms_Integration
  • Inbound_Mailer_Load_Templates
  • Inbound_Mailer_Menus
  • Inbound_Mailer_Metaboxes
  • Inbound_Mailer_Notifications
  • Inbound_Mailer_Plugin
  • Inbound_Mailer_Post_Type
  • Inbound_Mailer_Scheduling
  • Inbound_Mailer_Settings
  • Inbound_Mailer_SparkPost
  • Inbound_Mailer_Stats_Report
  • Inbound_Mailer_Template_Manager
  • Inbound_Mailer_Template_Manager_List
  • Inbound_Mailer_Tokens
  • Inbound_Mailer_Tracking
  • Inbound_Mailer_Unsubscribe
  • Inbound_Mailer_Variations
  • Inbound_Mailer_WordPress_SEO
  • Inbound_Maintenance_Lists
  • Inbound_Marketing_Button
  • Inbound_Menus_Admin
  • Inbound_Menus_Adminbar
  • Inbound_Metaboxes_Automation
  • Inbound_Metaboxes_Leads
  • Inbound_Notifications
  • Inbound_Now_Store
  • Inbound_Options_API
  • Inbound_Pro_Activation
  • Inbound_Pro_Admin_Ajax_Listeners
  • Inbound_Pro_Automatic_Updates
  • Inbound_Pro_Downloads
  • Inbound_Pro_Notifications
  • Inbound_Pro_Oauth_Engine
  • Inbound_Pro_Plugin
  • Inbound_Pro_Settings
  • Inbound_Quick_View
  • Inbound_Reporting_Templates
  • Inbound_Search_And_Comment_Report
  • Inbound_Shared_ACF_BootStrap
  • Inbound_Shortcodes
  • Inbound_Shortcodes_Cookies
  • Inbound_Shortcodes_Fields
  • Inbound_SparkPost
  • Inbound_SparkPost_Stats
  • Inbound_Template_Utils
  • Inbound_Templating_Engine
  • Inbound_Tracking
  • Inbound_Translation_Updater
  • Inbound_Updater
  • Inbound_Upgrade_For_More_Reports
  • Inbound_Upgrade_Routines
  • Inbound_Visitor_Event_Report
  • Inbound_Visitor_Impressions_Report
  • Inbound_Visitors_Report
  • INBOUNDNOW_EXTEND
  • Landing_Pages_ACF
  • Landing_Pages_Activation
  • Landing_Pages_Activation_Update_Routines
  • Landing_Pages_Admin_Menus
  • Landing_Pages_Admin_Notices
  • Landing_Pages_Install
  • Landing_Pages_Load_Extensions
  • Landing_Pages_Meta
  • Landing_Pages_Metaboxes
  • Landing_Pages_Post_Type
  • Landing_Pages_Row_Actions
  • Landing_Pages_Settings
  • Landing_Pages_Sidebars
  • Landing_Pages_Split_Testing_Stats
  • Landing_Pages_Template_Management
  • Landing_Pages_Template_Switcher
  • Landing_Pages_Templates_List_Table
  • Landing_Pages_Variations
  • LandingPages_Welcome
  • Leads_Activation
  • Leads_Activation_Update_Routines
  • Leads_Admin_Notices
  • Leads_Batch_Processor
  • Leads_Branching
  • Leads_Dashboard
  • Leads_Field_Map
  • Leads_Manager
  • Leads_Post_Type
  • Leads_Settings
  • Leads_Tracking
  • Leads_User_Profile
  • LeadStorage
  • LP_EXTENSION_LICENSENING
  • LP_EXTENSION_UPDATER
  • LP_Variation_Rotation
  • LP_Widget_Conversion_Area

Functions

  • cta_check_active
  • cta_example_template_function
  • cta_load_dynamic_widget
  • CTA_Load_Extensions
  • cta_load_static_widget
  • CTA_Render
  • inbound_add_conversion_to_lead
  • inbound_automation_check_active
  • inbound_automation_load_definitions
  • inbound_automation_metaboxes
  • inbound_automation_processing
  • inbound_color
  • inbound_color_scheme
  • inbound_confirm_email_service_provider
  • inbound_email_kill_ie8
  • inbound_email_load_templates
  • inbound_form_add_lead_list
  • inbound_form_auto_publish
  • inbound_form_delete_transient
  • inbound_form_get_data
  • inbound_form_save
  • inbound_forms_change_columns
  • inbound_forms_cpt
  • inbound_forms_custom_columns
  • inbound_forms_default_content
  • inbound_get_form_names
  • inbound_get_parent_directory
  • inbound_Hex_2_RGB
  • inbound_inbound_email_example_template_function
  • inbound_load_lead_manager
  • inbound_load_token_engine
  • inbound_mailer_acf_integration
  • Inbound_Mailer_Common_Settings
  • Inbound_Mailer_Load_Templates
  • inbound_qtrans_disable
  • inbound_record_log
  • inbound_register_form_role_capabilities
  • inbound_shortcode_alert
  • inbound_shortcode_callout
  • inbound_shortcode_columns
  • inbound_shortcode_content_box
  • inbound_shortcode_divider
  • inbound_shortcode_empty_paragraph_fix
  • inbound_shortcode_four_fifth_columns
  • inbound_shortcode_full_columns
  • inbound_shortcode_gmap
  • inbound_shortcode_icon
  • inbound_shortcode_intro
  • inbound_shortcode_landing_pages
  • inbound_shortcode_leadp
  • inbound_shortcode_list_icons
  • inbound_shortcode_one_fifth_columns
  • inbound_shortcode_one_fourth_columns
  • inbound_shortcode_one_half_columns
  • inbound_shortcode_one_third_columns
  • inbound_shortcode_portfolio
  • inbound_shortcode_pricing
  • inbound_shortcode_profile
  • inbound_shortcode_social_links
  • inbound_shortcode_tabs
  • inbound_shortcode_teaser
  • inbound_shortcode_testimonial
  • inbound_shortcode_three_fifth_columns
  • inbound_shortcode_three_fourth_columns
  • inbound_shortcode_two_fifth_columns
  • inbound_shortcode_two_third_columns
  • inbound_shortcode_video
  • inbound_store_lead
  • inbound_template_brightness
  • inbound_template_color
  • Inbound_Templating_Engine
  • inbound_travis_check
  • inboundnow_add_master_license
  • json_encode_fallback
  • landingpage_fix_known_wp_title_isses
  • landingpages_is_active
  • load_CTA_Settings
  • load_CTA_Template_Manager
  • load_Inbound_API_Keys_Generation
  • load_Inbound_Lead_Statuses
  • load_Inbound_Leads_Custom_fields
  • load_inbound_mail_daemon
  • load_Inbound_Mailer_Settings
  • load_Inbound_Mailer_Template_Manager
  • load_Inbound_Pro_Downloads
  • lp_ab_testing_get_current_variation_id
  • lp_add_option
  • lp_body_class
  • lp_check_active
  • lp_content_area
  • lp_conversion_area
  • lp_discover_important_wrappers
  • lp_footer
  • lp_generate_drowndown
  • lp_get_parent_directory
  • lp_get_value
  • lp_global_config
  • lp_head
  • lp_in_admin_header
  • lp_init
  • lp_list_feature
  • lp_load_widgets
  • lp_main_headline
  • lp_manage_templates
  • lp_move_template_files
  • lp_rebuild_attributes
  • lp_templates_upload
  • mailer_check_active
  • wp_cta_check_active
  • wp_cta_kill_ie8
  • wp_cta_load_calls_to_action
  • wp_leads_get_page_final_id
  • wpl_url_to_postid
  • wpleads_add_lead_to_list
  • wpleads_check_active
  • wpleads_get_lead_lists_as_array
  • Overview
  • Package
  • Class
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: 286: 287: 288: 289: 290: 291: 292: 293: 294: 295: 296: 297: 298: 299: 300: 301: 302: 303: 304: 305: 306: 307: 308: 309: 310: 311: 312: 313: 314: 315: 316: 317: 318: 319: 320: 321: 322: 323: 324: 325: 326: 327: 328: 329: 330: 331: 332: 333: 334: 335: 336: 337: 338: 339: 340: 341: 342: 343: 344: 345: 346: 347: 348: 349: 350: 351: 352: 353: 354: 355: 356: 357: 358: 359: 360: 361: 362: 363: 364: 365: 366: 367: 368: 369: 370: 371: 372: 373: 374: 375: 376: 377: 378: 379: 380: 381: 382: 383: 384: 385: 386: 387: 388: 389: 390: 391: 392: 393: 394: 395: 396: 397: 398: 399: 400: 401: 402: 403: 404: 405: 406: 407: 408: 409: 410: 411: 412: 413: 414: 415: 416: 417: 418: 419: 420: 421: 422: 423: 424: 425: 426: 427: 428: 429: 430: 431: 432: 433: 434: 435: 436: 437: 438: 439: 440: 441: 442: 443: 444: 445: 446: 447: 448: 449: 450: 451: 452: 453: 454: 455: 456: 457: 458: 459: 460: 461: 462: 463: 464: 465: 466: 467: 468: 469: 470: 471: 472: 473: 474: 475: 476: 477: 478: 479: 480: 481: 482: 483: 484: 485: 486: 487: 488: 489: 490: 491: 492: 493: 494: 495: 496: 497: 498: 499: 500: 501: 502: 503: 504: 505: 506: 507: 508: 509: 510: 511: 512: 513: 514: 515: 516: 517: 518: 519: 520: 521: 522: 523: 524: 525: 526: 527: 528: 529: 530: 531: 532: 533: 534: 535: 536: 537: 538: 539: 540: 541: 542: 543: 544: 545: 546: 547: 548: 549: 550: 551: 552: 553: 554: 555: 556: 557: 558: 559: 560: 561: 562: 563: 564: 565: 566: 567: 568: 569: 570: 571: 572: 573: 574: 575: 576: 577: 578: 579: 580: 581: 582: 583: 584: 585: 586: 587: 588: 589: 590: 591: 592: 593: 594: 595: 596: 597: 598: 599: 600: 601: 602: 603: 604: 605: 606: 607: 608: 609: 610: 611: 612: 613: 614: 615: 616: 617: 618: 619: 620: 621: 622: 623: 624: 625: 626: 627: 628: 629: 630: 631: 632: 633: 634: 635: 636: 637: 638: 639: 640: 641: 642: 643: 644: 645: 646: 647: 648: 649: 650: 
<?php

/**
 * Class interface for retrieving email variation elements and recording "online version" event statistics
 * @package Mailer
 * @subpackage Variations
 */

class Inbound_Mailer_Variations {

    public function __construct() {
        self::load_hooks();
    }

    public static function load_hooks() {

        /* Filter to add variation id to end of meta key */
        add_filter( 'inbound_email_prepare_input_id' , array( __CLASS__ , 'prepare_input_id' ) );

        /* Appends variation id to given url */
        add_filter( 'inbound_email_customizer_customizer_link', array( __CLASS__ , 'append_variation_id_to_url') );
        add_filter( 'post_type_link', array( __CLASS__ , 'append_variation_id_to_url') );

        /* Records impression for cta */
        add_action( 'inbound_email_record_impression' , array( __CLASS__ , 'record_impression' ) , 10, 2);

        /* Records conversion for cta */
        add_action( 'inbound_email_record_conversion' , array( __CLASS__ , 'record_conversion' ) , 10, 2);
    }


    /**
    * Deletes variation for a call to action
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation to delete
    *
    */
    public static function delete_variation( $inbound_email_id  ,   $vid ) {

        /* Update variations meta object */
        $variations = self::get_variations( $inbound_email_id );
        unset($variations[$vid]);

        self::update_variations( $inbound_email_id , $variations );

        /* Get first array variation and set it as open variation */
        reset($variations);
        $vid = key($variations);
        $_SESSION[ $inbound_email_id . '-variation-id'] = $vid;
    }

    /**
    * Pauses variation for a call to action
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation to delete
    *
    */
    public static function pause_variation( $inbound_email_id   ,   $vid ) {

        /* Update variations meta object */
        $variations = self::get_variations( $inbound_email_id );
        $variations[ $vid ]['status'] = 'paused';

        self::update_variations( $inbound_email_id , $variations );
    }

    /**
    * Activations variation for a call to action
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation to play
    *
    */
    public static function play_variation( $inbound_email_id    ,   $vid ) {

        /* Update variations meta object */
        $variations = self::get_variations( $inbound_email_id );
        $variations[ $vid ]['status'] = 'active';

        self::update_variations( $inbound_email_id , $variations );
    }

    /**
    * Sets the variation status to a custom status
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation to delete
    * @param STRING $status custom status
    *
    */
    public static function set_variation_status( $inbound_email_id , $vid , $status = 'play' ) {

        /* Update variations meta object */
        $variations = self::get_variations( $inbound_email_id );
        $variations[ $vid ]['status'] = $status ;

        self::update_variations( $inbound_email_id , $variations );
    }


    /**
    * Returns array of variation data given a call to action id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of specific variation
    *
    * @returns ARRAY of variation data
    */
    public static function get_variations( $inbound_email_id , $vid = null ) {

        $settings = Inbound_Email_Meta::get_settings( $inbound_email_id );
        $variations = ( isset($settings['variations']) ) ? $settings['variations'] : array( 0 => array( 'status' => 'active' ) );

        return $variations;
    }


    /**
    * Returns the status of a variation given inbound_email_id and vid
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid variation id of call to action
    *
    * @returns STRING status
    */
    public static function get_variation_status( $inbound_email_id , $vid = null ) {

        if ( $vid === null ) {
            $vid = Inbound_Mailer_Variations::get_current_variation_id();
        }

        $variations = Inbound_Mailer_Variations::get_variations( $inbound_email_id );
        $status = ( is_array( $variations ) && isset($variations[ $vid ][ 'status' ]) ) ? $variations[ $vid ][ 'status' ] : 'active';

        return $status;
    }


    /**
    *  Set Variant Marker - When automated emails are sent we still want to rotate variations if they exist. When an email is bein sent to one lead, batching needs a consistant way to rotate variations
    *  @param INT $inbound_email_id
    *  @return INT $next_variant_marker
    */
    public static function get_next_variant_marker( $inbound_email_id ) {

        /* get email settins */
        $settings = Inbound_Email_Meta::get_settings( $inbound_email_id );

        /* get variations */
        $variations = ( isset($settings['variations']) ) ? $settings['variations'] : array( 0 => array( 'status' => 'active' ) );

        /* count variatons */
        $variation_count = count($variations);

        /* if only one variation return appropraite variant id */
        if ( $variation_count == 1 ) {
            return current(array_keys($variations));
        }

        /* get last known variation marker if it exists else create it with first key in array */
        $variation_marker = ( !empty($settings['variation_marker']) ) ? $settings['variation_marker'] : current(array_keys($variations));

        /* safety fallback */
        if (empty($variation_marker) && $variation_marker !== 0 ) {
            return 0;
        }

        /* set pointer to variation id in array */
        $i = 0;
        while (key($variations) !== $variation_marker) {

            next($variations);

            $i++;

            if ($i>99999) {
                echo 'break';
                break;
            }
        }

        /* Save future variation marker */
        next($variations);
        Inbound_Mailer_Variations::set_variation_marker( $inbound_email_id , key($variations) );

        /* return next pointer in line */
        return $variation_marker;

    }

    /**
    *  Updates variation marker (used for single sends)
    *  @param INT $inbound_email_id
    *  @param INT $variation_marker
    */
    public static function set_variation_marker( $inbound_email_id , $variation_marker ) {
        /* get email settins */
        $settings = Inbound_Email_Meta::get_settings( $inbound_email_id );
        $settings['variation_marker'] = $variation_marker;
        Inbound_Email_Meta::update_settings( $inbound_email_id , $settings );
    }

    /**
    * Returns the permalink of a variation given inbound_email_id and vid
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid variation id of call to action
    *
    * @returns STRING permalink
    */
    public static function get_variation_permalink( $inbound_email_id , $vid = null ) {

        if ( $vid === null ) {
            $vid = Inbound_Mailer_Variations::get_current_variation_id();
        }

        $permalink = get_permalink($inbound_email_id);

        return add_query_arg( array('inbvid'=> $vid ) , $permalink ) ;
    }

    /**
    * Updates 'inbound-email-variations' meta key with json object
    *
    * @param INT $inbound_email_id id of call to action
    * @param variations ARRAY of variation data
    *
    */
    public static function update_variations ( $inbound_email_id , $variations ) {

        $settings = Inbound_Email_Meta::get_settings( $inbound_email_id );
        $settings[ 'variations' ] = $variations;
        Inbound_Email_Meta::update_settings( $inbound_email_id , $settings );

    }


    /**
    * Returns array of variation specific meta data
    *
    * @param INT $inbound_email_id ID of call to action
    * @param INT $vid ID of variation belonging to call to action
    *
    * @return ARRAY $meta array of variation meta data
    */
    public static function get_variation_meta ( $inbound_email_id , $vid ) {
        $meta = array();

        $inbound_email_meta = get_post_meta( $inbound_email_id );

        $suffix = '-'.$vid;
        $len = strlen($suffix);

        foreach ($inbound_email_meta as $key=>$value)
        {
            if (substr($key,-$len)==$suffix)
            {
                $meta[$key] = $value[0];
            }
        }

        return $meta;
    }

    /**
    * Gets the call to action variation notes
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid variation id of call to action variation, will attempt to autodetect if left as null
    *
    * @return STRING $notes variation notes.
    */
    public static function get_variation_notes ( $inbound_email_id , $vid = null) {

        if ( $vid === null ) {
            $vid = Inbound_Mailer_Variations::get_current_variation_id();
        }

        $notes = get_post_meta( $inbound_email_id , 'mailer-variation-notes-' . $vid , true );

        return $notes;

    }

    /**
    * Gets the call to action variation custom css
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid variation id of call to action variation, will attempt to autodetect if left as null
    *
    * @return STRING $custom_css.
    */
    public static function get_variation_custom_css ( $inbound_email_id , $vid = null) {

        if ( $vid === null ) {
            $vid = Inbound_Mailer_Variations::get_current_variation_id();
        }

        $custom_css = get_post_meta( $inbound_email_id , 'mailer-custom-css-' . $vid , true );

        return $custom_css;

    }

    /**
    * Gets the call to action variation custom js
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid variation id of call to action variation, will attempt to autodetect if left as null
    *
    * @return STRING $custom_js.
    */
    public static function get_variation_custom_js ( $inbound_email_id , $vid = null) {

        if ( $vid === null ) {
            $vid = Inbound_Mailer_Variations::get_current_variation_id();
        }

        $custom_js = get_post_meta( $inbound_email_id , 'mailer-custom-js-' . $vid , true );

        return $custom_js;

    }

    /* Adds variation id onto base meta key
    *
    * @param id STRING of meta key to store data into for given setting
    * @param INT $vid id of variation belonging to call to action, will attempt to autodetect if left as null
    *
    * @returns STRING of meta key appended with variation id
    */
    public static function prepare_input_id( $id , $vid = null ) {

        if ( $vid === null ) {
            $vid =  Inbound_Mailer_Variations::get_current_variation_id();
        }

        return $id . '-' . $vid;
    }

    /*
    * Gets the current variation id
    *
    * @returns INT of variation id
    */
    public static function get_current_variation_id() {
        global $post;

        if (isset($_REQUEST['inbvid'])){
            return intval($_REQUEST['inbvid']);
        }

        $post_id = (isset($post->ID)) ? $post->ID : intval($_REQUEST['post']);

        if (isset($_SESSION[ $post_id . '-variation-id'])) {
            return $_SESSION[ $post_id . '-variation-id'];
        }

        return 0;
    }

    /*
    * Gets the next available variation id
    *
    * @returns INT of variation id
    */
    public static function get_next_available_variation_id( $inbound_email_id ) {

        $variations = Inbound_Mailer_Variations::get_variations( $inbound_email_id );
        $array_variations = $variations;

        end($array_variations);

        $last_variation_id = key($array_variations);

        return $last_variation_id + 1;
    }

    /*
    * Gets string id of template given email id
    *
    * @param INT $inbound_email_id of call to action
    * @param INT $vid of variation id
    *
    * @returns STRING id of selected template
    */
    public static function get_current_template( $inbound_email_id , $vid = null ) {

        if ( $vid === null ) {
            $vid =  Inbound_Mailer_Variations::get_current_variation_id();
        }

        $settings = Inbound_Email_Meta::get_settings( $inbound_email_id );
        $variations = ( isset($settings['variations']) ) ? $settings['variations'] : null;

        $template = ( isset( $variations[ $vid ][ 'selected_template' ] ) ) ? $variations[ $vid ][ 'selected_template' ] : 'simple-responsive';

        /* If new variation use historic template id */
        if ( isset($_GET['new-variation'] ) ) {
            $vid = key($variations);
            $template = ( isset( $variations[ $vid ][ 'selected_template' ] ) ) ? $variations[ $vid ][ 'selected_template' ] : 'simple-responsive';
        }

        return $template;

    }

    /**
    * Get Screenshot URL for email preview. If local environment show template thumbnail.
    *
    * @param INT $inbound_email_id id if of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    * @return STRING url of preview
    */
    public static function get_screenshot_url( $inbound_email_id , $vid = null) {

        if ( $vid === null ) {
            $vid =  Inbound_Mailer_Variations::get_current_variation_id();
        }

        $template = Inbound_Mailer_Variations::get_current_template( $inbound_email_id , $vid);

        if (in_array($_SERVER['REMOTE_ADDR'], array('127.0.0.1', '::1'))) {

            if (file_exists(INBOUND_EMAIL_PATH . 'templates/' . $template . '/thumbnail.png')) {
                $screenshot = INBOUND_EMAIL_URLPATH . 'templates/' . $template . '/thumbnail.png';
            } else if (file_exists(INBOUND_EMAIL_UPLOADS_PATH . 'templates/' . $template . '/thumbnail.png')) {
                $screenshot = INBOUND_EMAIL_UPLOADS_URLPATH . 'templates/' . $template . '/thumbnail.png';
            } else if (file_exists(INBOUND_EMAIL_THEME_TEMPLATES_PATH . 'templates/' . $template . '/thumbnail.png')) {
                $screenshot = INBOUND_EMAIL_THEME_TEMPLATES_URLPATH . 'templates/' . $template . '/thumbnail.png';
            }

        } else {
            $screenshot = 'http://s.wordpress.com/mshots/v1/' . urlencode(esc_url($permalink)) . '?w=140';
        }

        return $screenshot;
    }

    /**
    * Appends current variation id onto a URL
    *
    * @param link STRING URL that param will be appended onto
    *
    *
    * @return STRING modified URL.
    */
    public static function append_variation_id_to_url( $link ) {
        global $post;

        if ( !isset($post) || $post->post_type != 'inbound-email' ) {
            return $link;
        }

        $current_variation_id = Inbound_Mailer_Variations::get_current_variation_id();


        $link = add_query_arg( array('inbvid' => $current_variation_id ) , $link );

        return $link;
    }

    /**
    * Discovers which alphabetic letter should be associated with a given cta's variation id.
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    * @return STRING alphebit letter.
    */
    public static function vid_to_letter( $inbound_email_id , $vid ) {
        $variations = Inbound_Mailer_Variations::get_variations( $inbound_email_id );

        $i = 0;
        foreach ($variations as $key => $variation ) {
            if ( $vid == $key ) {
                break;
            }
            $i++;
        }

        $alphabet = array(
            __( 'A' , 'inbound-pro' ),
            __( 'B' , 'inbound-pro' ),
            __( 'C' , 'inbound-pro' ),
            __( 'D' , 'inbound-pro' ),
            __( 'E' , 'inbound-pro' ),
            __( 'F' , 'inbound-pro' ),
            __( 'G' , 'inbound-pro' ),
            __( 'H' , 'inbound-pro' ),
            __( 'I' , 'inbound-pro' ),
            __( 'J' , 'inbound-pro' ),
            __( 'K' , 'inbound-pro' ),
            __( 'L' , 'inbound-pro' ),
            __( 'M' , 'inbound-pro' ),
            __( 'N' , 'inbound-pro' ),
            __( 'O' , 'inbound-pro' ),
            __( 'P' , 'inbound-pro' ),
            __( 'Q' , 'inbound-pro' ),
            __( 'R' , 'inbound-pro' ),
            __( 'S' , 'inbound-pro' ),
            __( 'T' , 'inbound-pro' ),
            __( 'U' , 'inbound-pro' ),
            __( 'V' , 'inbound-pro' ),
            __( 'W' , 'inbound-pro' ),
            __( 'X' , 'inbound-pro' ),
            __( 'Y' , 'inbound-pro' ),
            __( 'Z' , 'inbound-pro' )
        );

        if (isset($alphabet[$i])){
            return $alphabet[$i];
        }
    }

    /**
    * Returns impression for given cta and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    * @return INT impression count
    */
    public static function get_impressions( $inbound_email_id , $vid ) {

        $impressions = get_post_meta( $inbound_email_id ,'mailer-ab-variation-impressions-'.$vid , true);

        if (!is_numeric($impressions)) {
            $impressions = 0;
        }

        return $impressions;
    }

    /**
    * Increments impression count for given cta and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    */
    public static function record_impression( $inbound_email_id , $vid ) {

        $impressions = get_post_meta( $inbound_email_id ,'mailer-ab-variation-impressions-'.$vid, true);

        if (!is_numeric($impressions)) {
            $impressions = 1;
        } else {
            $impressions++;
        }

        update_post_meta( $inbound_email_id , 'mailer-ab-variation-impressions-'.$vid , $impressions);
    }

    /**
    * Manually sets conversion count for given cta id and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    */
    public static function set_impression_count( $inbound_email_id , $vid , $count) {

        update_post_meta( $inbound_email_id , 'mailer-ab-variation-impressions-'.$vid , $count);
    }

    /**
    * Returns impression for given cta and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    * @return INT impression count
    */
    public static function get_conversions( $inbound_email_id , $vid ) {

        $conversions = get_post_meta( $inbound_email_id ,'mailer-ab-variation-conversions-'.$vid, true);

        if (!is_numeric($conversions)) {
            $conversions = 0;
        }

        return $conversions;
    }

    /**
    * Returns conversion rate for given cta and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    * @return INT conversion rate
    */
    public static function get_conversion_rate( $inbound_email_id , $vid ) {

        $impressions = Inbound_Mailer_Variations::get_impressions( $inbound_email_id , $vid );
        $conversions = Inbound_Mailer_Variations::get_conversions( $inbound_email_id , $vid );

        if ($impressions>0) {
            $conversion_rate = $conversions / $impressions;
            $conversion_rate_number = $conversion_rate * 100;
            $conversion_rate_number = round($conversion_rate_number, 2);
            $conversion_rate = $conversion_rate_number;
        } else {
            $conversion_rate = 0;
        }

        return $conversion_rate;
    }

    /**
    * Increments conversion count for given cta id and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    */
    public static function record_conversion(   $inbound_email_id , $vid ) {

        $conversions = get_post_meta( $inbound_email_id , 'mailer-ab-variation-conversions-' . $vid , true);

        if (!is_numeric($conversions)) {
            $conversions = 1;
        } else {
            $conversions++;
        }

        update_post_meta( $inbound_email_id , 'mailer-ab-variation-conversions-'.$vid , $conversions);
    }

    /**
    * Manually sets conversion count for given cta id and variation id
    *
    * @param INT $inbound_email_id id of call to action
    * @param INT $vid id of variation belonging to call to action
    *
    */
    public static function set_conversion_count(    $inbound_email_id , $vid , $count) {

        update_post_meta( $inbound_email_id , 'mailer-ab-variation-conversions-'.$vid , $count);
    }

}

$GLOBALS['Inbound_Mailer_Variations'] = new Inbound_Mailer_Variations();

Inbound Pro Plugin - PHP Codex API documentation generated by ApiGen