ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / sothebankuab.com / wp-content / plugins / sendgrid-email-delivery-simplified / lib

<?php

class Sendgrid_Tools
{
  const CACHE_GROUP = "sendgrid";
  const CHECK_CREDENTIALS_CACHE_KEY = "sendgrid_credentials_check";
  const CHECK_API_KEY_CACHE_KEY = "sendgrid_api_key_check";
  const CHECK_API_KEY_STATS_CACHE_KEY = "sendgrid_api_key_stats_check";
  const VALID_CREDENTIALS_STATUS = "valid";
  const DEFAULT_TIMEOUT = 5;

// used static variable because php 5.3 doesn't support array as constant
  public static $allowed_ports = array( Sendgrid_SMTP::TLS, Sendgrid_SMTP::TLS_ALTERNATIVE, Sendgrid_SMTP::SSL, Sendgrid_SMTP::TLS_ALTERNATIVE_2 );
  public static $allowed_content_type = array( 'plaintext', 'html' );

/**
   * Returns a sendgrid plugin option
   *
   * @return  string
   */
  public static function get_sendgrid_option( $option, $default = false ) {
    if ( ! is_multisite() || ( is_multisite() and ! is_main_site() and get_option( 'sendgrid_can_manage_subsite' ) ) ) {
      return get_option( "sendgrid_$option", $default );
    } else {
      return get_site_option( "sendgrid_$option", $default );
    }
  }

/**
   * Updates a sendgrid plugin option
   *
   * @return  string
   */
  public static function update_sendgrid_option( $option, $value ) {
    if ( ! is_multisite() || ( is_multisite() and ! is_main_site() and get_option( 'sendgrid_can_manage_subsite' ) ) ) {
      return update_option( "sendgrid_$option", $value );
    } else {
      return update_site_option( "sendgrid_$option", $value );
    }
  }

/**
   * Deletes a sendgrid plugin option
   *
   * @return  string
   */
  public static function delete_sendgrid_option( $option ) {
    if ( ! is_multisite() || ( is_multisite() and ! is_main_site() and get_option( 'sendgrid_can_manage_subsite' ) ) ) {
      return delete_option( "sendgrid_$option" );
    } else {
      return delete_site_option( "sendgrid_$option" );
    }
  }

/**
   * Check username/password
   *
   * @param   string  $username   sendgrid username
   * @param   string  $password   sendgrid password
   *
   * @return  bool
   */
  public static function check_username_password( $username, $password, $clear_cache = false )
  {
    if ( ! $username or ! $password ) {
      return false;
    }

if ( $clear_cache ) {
      self::set_transient_sendgrid( self::CHECK_CREDENTIALS_CACHE_KEY, null );
    }

$valid_username_password = self::get_transient_sendgrid( self::CHECK_CREDENTIALS_CACHE_KEY );

if ( self::VALID_CREDENTIALS_STATUS == $valid_username_password ) {
      return true;
    }

$url = 'https://api.sendgrid.com/api/profile.get.json?';
    $url .= "api_user=" . urlencode( $username ) . "&api_key=" . urlencode( $password );

$response = wp_remote_get(
      $url,
      array(
        'decompress' => false,
        'timeout' => Sendgrid_Tools::get_request_timeout()
      )
    );

if ( ! is_array( $response ) or ! isset( $response['body'] ) ) {
      return false;
    }

$response = json_decode( $response['body'], true );

if ( isset( $response['error'] ) ) {
      return false;
    }

self::set_transient_sendgrid( self::CHECK_CREDENTIALS_CACHE_KEY, self::VALID_CREDENTIALS_STATUS, 2 * 60 * 60 );

return true;
  }

/**
   * Check apikey scopes
   *
   * @param   string  $apikey   sendgrid apikey
   *
   * @return  bool
   */
  public static function check_api_key_scopes( $apikey, $scopes )
  {
    if ( ! $apikey or ! is_array( $scopes ) ) {
      return false;
    }

$url = 'https://api.sendgrid.com/v3/scopes';

$args = array(
      'headers' => array(
        'Authorization' => 'Bearer ' . $apikey ),
      'decompress' => false,
      'timeout' => Sendgrid_Tools::get_request_timeout()
    );

$response = wp_remote_get( $url, $args );

if ( ! is_array( $response ) or ! isset( $response['body'] ) ) {
      return false;
    }

$response = json_decode( $response['body'], true );

if ( isset( $response['errors'] ) ) {
      return false;
    }

if ( ! isset( $response['scopes'] ) ) {
      return false;
    }

foreach ( $scopes as $scope ) {
      if ( ! in_array( $scope, $response['scopes'] ) ) {
        return false;
      }
    }

return true;
  }

/**
   * Check apikey
   *
   * @param   string  $apikey   sendgrid apikey
   *
   * @return  bool
   */
  public static function check_api_key( $apikey, $clear_cache = false )
  {
    if ( ! $apikey ) {
      return false;
    }

if ( $clear_cache ) {
      self::set_transient_sendgrid( self::CHECK_API_KEY_CACHE_KEY, null );
    }

$valid_apikey = self::get_transient_sendgrid( self::CHECK_API_KEY_CACHE_KEY );

if ( self::VALID_CREDENTIALS_STATUS == $valid_apikey ) {
      return true;
    }

// check unsubscribe group permission
    if ( Sendgrid_Tools::check_api_key_scopes( $apikey, array( "asm.groups.read" ) ) ) {
      Sendgrid_Tools::set_asm_permission( 'true' );
    } else {
      Sendgrid_Tools::set_asm_permission( 'false' );
    }

if ( ! Sendgrid_Tools::check_api_key_scopes( $apikey, array( "mail.send" ) ) ) {
      return false;
    }

self::set_transient_sendgrid( self::CHECK_API_KEY_CACHE_KEY, self::VALID_CREDENTIALS_STATUS, 2 * 60 * 60 );

return true;
  }

/**
   * Check template
   *
   * @param   string  $template   sendgrid template
   *
   * @return  bool
   */
  public static function check_template( $template )
  {
    if ( '' == $template ) {
      return true;
    }

$url = 'v3/templates/' . $template;

$response = Sendgrid_Tools::do_request( $url );

if ( ! $response ) {
      return false;
    }

$response = json_decode( $response, true );
    if ( isset( $response['error'] ) or ( isset( $response['errors'] ) and isset( $response['errors'][0]['message'] ) ) ) {
      return false;
    }

return true;
  }

/**
   * Make request to SendGrid API
   *
   * @param   type  $api
   * @param   type  $parameters
   *
   * @return  json
   */
  public static function do_request( $api = 'v3/stats', $parameters = array() )
  {
    $args = array(
      'headers' => array(
        'Authorization' => 'Bearer ' . self::get_api_key()
      ),
      'decompress' => false,
      'timeout' => Sendgrid_Tools::get_request_timeout()
    );

$data = urldecode( http_build_query( $parameters ) );
    $url = "https://api.sendgrid.com/$api?$data";

$response = wp_remote_get( $url, $args );

if ( ! is_array( $response ) or ! isset( $response['body'] ) ) {
      return false;
    }

return $response['body'];
  }

/**
   * Return api_key from the database or global variable
   *
   * @return  mixed   api key, false if the value is not found
   */
  public static function get_api_key()
  {
    if ( defined( 'SENDGRID_API_KEY' ) ) {
      return SENDGRID_API_KEY;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'api_key' );
    }
  }

/**
   * Return MC api_key from the database or global variable
   *
   * @return  mixed   api key, false if the value is not found
   */
  public static function get_mc_api_key()
  {
    if ( defined( 'SENDGRID_MC_API_KEY' ) ) {
      return SENDGRID_MC_API_KEY;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_api_key' );
    }
  }

/**
   * Return list_id from the database or global variable
   *
   * @return  mixed   list id, false if the value is not found
   */
  public static function get_mc_list_id()
  {
    if ( defined( 'SENDGRID_MC_LIST_ID' ) ) {
      return SENDGRID_MC_LIST_ID;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_list_id' );
    }
  }

/**
   * Return the value for the option to use the transactional credentials from the database or global variable
   *
   * @return  mixed   'true' or 'false', false if the value is not found
   */
  public static function get_mc_opt_use_transactional()
  {
    if ( defined( 'SENDGRID_MC_OPT_USE_TRANSACTIONAL' ) ) {
      return SENDGRID_MC_OPT_USE_TRANSACTIONAL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_opt_use_transactional' );
    }
  }

/**
   * Return the value for the option to require first name and last name on subscribe from the database or global variable
   *
   * @return  mixed  'true' or 'false', false if the value is not found
   */
  public static function get_mc_opt_req_fname_lname()
  {
    if ( defined( 'SENDGRID_MC_OPT_REQ_FNAME_LNAME' ) ) {
      return SENDGRID_MC_OPT_REQ_FNAME_LNAME;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_opt_req_fname_lname' );
    }
  }

/**
   * Return the value for the option to include first name and last name on subscribe from the database or global variable
   *
   * @return  mixed  'true' or 'false', false if the value is not found
   */
  public static function get_mc_opt_incl_fname_lname()
  {
    if ( defined( 'SENDGRID_MC_OPT_INCL_FNAME_LNAME' ) ) {
      return SENDGRID_MC_OPT_INCL_FNAME_LNAME;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_opt_incl_fname_lname' );
    }
  }

/**
   * Return the value for the signup email subject from the database or global variable
   *
   * @return  mixed   signup email subject, false if the value is not found
   */
  public static function get_mc_signup_email_subject()
  {
    if ( defined( 'SENDGRID_MC_SIGNUP_EMAIL_SUBJECT' ) ) {
      return SENDGRID_MC_SIGNUP_EMAIL_SUBJECT;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_signup_email_subject' );
    }
  }

/**
   * Return the value for the signup email contents from the database or global variable
   *
   * @return  mixed   signup email contents, false if the value is not found
   */
  public static function get_mc_signup_email_content()
  {
    if ( defined( 'SENDGRID_MC_SIGNUP_EMAIL_CONTENT' ) ) {
      return SENDGRID_MC_SIGNUP_EMAIL_CONTENT;
    } else {
      $signup_email_content = Sendgrid_Tools::get_sendgrid_option( 'mc_signup_email_content' );
      return htmlspecialchars_decode( $signup_email_content, ENT_QUOTES );
    }
  }

/**
   * Return the value for the signup email contents (plain text) from the database or global variable
   *
   * @return  mixed   signup email contents - plain text, false if the value is not found
   */
  public static function get_mc_signup_email_content_text()
  {
    if ( defined( 'SENDGRID_MC_SIGNUP_EMAIL_CONTENT_TEXT' ) ) {
      return SENDGRID_MC_SIGNUP_EMAIL_CONTENT_TEXT;
    } else {
      $signup_email_text = Sendgrid_Tools::get_sendgrid_option( 'mc_signup_email_content_text' );
      return htmlspecialchars_decode( $signup_email_text, ENT_QUOTES );
    }
  }

/**
   * Return the value for the signup confirmation page from the database or global variable
   *
   * @return  mixed   signup confirmation page, false if the value is not found
   */
  public static function get_mc_signup_confirmation_page()
  {
    if ( defined( 'SENDGRID_MC_SIGNUP_CONFIRMATION_PAGE' ) ) {
      return SENDGRID_MC_SIGNUP_CONFIRMATION_PAGE;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_signup_confirmation_page' );
    }
  }

/**
   * Return the value for the signup confirmation page url
   *
   * @return  mixed   signup confirmation page url, false if the value is not found
   */
  public static function get_mc_signup_confirmation_page_url()
  {
    $page_id = self::get_mc_signup_confirmation_page();
    if ( false == $page_id or 'default' == $page_id ) {
      return false;
    }

$confirmation_pages = get_pages( array( 'parent' => 0 ) );
    foreach ( $confirmation_pages as $key => $page ) {
      if ( $page->ID == $page_id ) {
        return $page->guid;
      }
    }

return false;
  }

/**
   * Return the value for flag that signifies if the MC authentication settings are valid
   *
   * @return  mixed  'true' or 'false', false if the value is not found
   */
  public static function get_mc_auth_valid()
  {
    return Sendgrid_Tools::get_sendgrid_option( 'mc_auth_valid' );
  }

/**
   * Return the value for flag that signifies if the widget notice has been dismissed
   *
   * @return  mixed  'true' or 'false', false if the value is not found
   */
  public static function get_mc_widget_notice_dismissed()
  {
    return Sendgrid_Tools::get_sendgrid_option( 'mc_widget_notice_dismissed' );
  }

/**
   * Sets api_key in the database
   *
   * @param   type  string  $apikey
   *
   * @return  bool
   */
  public static function set_api_key( $apikey )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'api_key', $apikey );
  }

/**
   * Sets MC api_key in the database
   *
   * @param   type  string  $apikey
   *
   * @return  bool
   */
  public static function set_mc_api_key( $apikey )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_api_key', $apikey );
  }

/**
   * Sets list id in the database
   *
   * @param   type  string  $list_id
   *
   * @return  bool
   */
  public static function set_mc_list_id( $list_id )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_list_id', $list_id );
  }

/**
   * Sets the value for the option to use the transactional credentials in the database
   *
   * @param   type  string  $use_transactional ( 'true' or 'false' )
   *
   * @return  bool
   */
  public static function set_mc_opt_use_transactional( $use_transactional )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_opt_use_transactional', $use_transactional );
  }

/**
   * Sets the option for fname and lname requirement in the database
   *
   * @param   type  string  $req_fname_lname ( 'true' or 'false' )
   *
   * @return  bool
   */
  public static function set_mc_opt_req_fname_lname( $req_fname_lname )
  {
     return Sendgrid_Tools::update_sendgrid_option( 'mc_opt_req_fname_lname', $req_fname_lname );
  }

/**
   * Sets the option for fname and lname inclusion in the database
   *
   * @param   type  string  $incl_fname_lname ( 'true' or 'false' )
   *
   * @return  bool
   */
  public static function set_mc_opt_incl_fname_lname( $incl_fname_lname )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_opt_incl_fname_lname', $incl_fname_lname );
  }

/**
   * Sets the signup email subject in the database
   *
   * @param   type  string  $email_subject
   *
   * @return  bool
   */
  public static function set_mc_signup_email_subject( $email_subject )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_signup_email_subject', $email_subject );
  }

/**
   * Sets the signup email contents in the database
   *
   * @param   type  string  $email_content
   *
   * @return  bool
   */
  public static function set_mc_signup_email_content( $email_content )
  {
    $email_content = htmlspecialchars( $email_content, ENT_QUOTES, 'UTF-8' );
    return Sendgrid_Tools::update_sendgrid_option( 'mc_signup_email_content', $email_content );
  }

/**
   * Sets the signup email contents (plain text) in the database
   *
   * @param   type  string  $email_content
   *
   * @return  bool
   */
  public static function set_mc_signup_email_content_text( $email_content )
  {
    $email_content = htmlspecialchars( $email_content, ENT_QUOTES, 'UTF-8' );
    return Sendgrid_Tools::update_sendgrid_option( 'mc_signup_email_content_text', $email_content );
  }

/**
   * Sets the signup confirmation page in the database
   *
   * @param   type  string  $confirmation_page
   *
   * @return  bool
   */
  public static function set_mc_signup_confirmation_page( $confirmation_page )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_signup_confirmation_page', $confirmation_page );
  }

/**
   * Sets a flag that signifies that the authentication for MC is valid
   *
   * @param   type  string  $auth_valid ( 'true' or 'false' )
   *
   * @return  bool
   */
  public static function set_mc_auth_valid( $auth_valid )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_auth_valid', $auth_valid );
  }

/**
   * Sets a flag that signifies that the subscription widget notice has been dismissed
   *
   * @param   type  string  $notice_dismissed ( 'true' or 'false' )
   *
   * @return  bool
   */
  public static function set_mc_widget_notice_dismissed( $notice_dismissed )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_widget_notice_dismissed', $notice_dismissed );
  }

/**
   * Return send method from the database or global variable
   *
   * @return  string  send_method
   */
  public static function get_send_method()
  {
    if ( defined( 'SENDGRID_SEND_METHOD' ) ) {
      return SENDGRID_SEND_METHOD;
    } elseif ( Sendgrid_Tools::get_sendgrid_option( 'api', false ) ) {
      return Sendgrid_Tools::get_sendgrid_option( 'api' );
    } else {
      return 'api';
    }
  }

/**
   * Sets the send method in the database
   *
   * @param   type  string  $method
   *
   * @return  bool
   */
  public static function set_send_method( $method )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'api', $method );
  }

/**
   * Return port from the database or global variable
   *
   * @return  mixed   port, false if the value is not found
   */
  public static function get_port()
  {
    if ( defined( 'SENDGRID_PORT' ) ) {
      return SENDGRID_PORT;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'port', Sendgrid_SMTP::TLS );
    }
  }

/**
   * Sets the port in the database
   *
   * @param   type  string  $port
   *
   * @return  bool
   */
  public static function set_port( $port )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'port', $port );
  }

/**
   * Return from name from the database or global variable
   *
   * @return  mixed   from_name, false if the value is not found
   */
  public static function get_from_name()
  {
    if ( defined( 'SENDGRID_FROM_NAME' ) ) {
      return SENDGRID_FROM_NAME;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'from_name' );
    }
  }

/**
   * Sets from name in the database
   *
   * @param   type  string  $name
   *
   * @return  bool
   */
  public static function set_from_name( $name )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'from_name', $name );
  }

/**
   * Return from email address from the database or global variable
   *
   * @return  mixed  from_email, false if the value is not found
   */
  public static function get_from_email()
  {
    if ( defined( 'SENDGRID_FROM_EMAIL' ) ) {
      return SENDGRID_FROM_EMAIL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'from_email' );
    }
  }

/**
   * Sets from email in the database
   *
   * @param   type  string  $email
   *
   * @return  bool
   */
  public static function set_from_email( $email )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'from_email', $email );
  }

/**
   * Return reply to email address from the database or global variable
   *
   * @return  mixed  reply_to, false if the value is not found
   */
  public static function get_reply_to()
  {
    if ( defined( 'SENDGRID_REPLY_TO' ) ) {
      return SENDGRID_REPLY_TO;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'reply_to' );
    }
  }

/**
   * Sets reply to email in the database
   *
   * @param   type  string  $email
   *
   * @return  bool
   */
  public static function set_reply_to( $email )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'reply_to', $email );
  }

/**
   * Return categories from the database or global variable
   *
   * @return  mixed  categories, false if the value is not found
   */
  public static function get_categories()
  {
    if ( defined( 'SENDGRID_CATEGORIES' ) ) {
      return SENDGRID_CATEGORIES;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'categories' );
    }
  }

/**
   * Sets categories in the database
   *
   * @param   type  string  $categories
   *
   * @return  bool
   */
  public static function set_categories( $categories )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'categories', $categories );
  }

/**
   * Return stats categories from the database or global variable
   *
   * @return  mixed  categories, false if the value is not found
   */
  public static function get_stats_categories()
  {
    if ( defined( 'SENDGRID_STATS_CATEGORIES' ) ) {
      return SENDGRID_STATS_CATEGORIES;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'stats_categories' );
    }
  }

/**
   * Sets stats categories in the database
   *
   * @param   type  string  $categories
   *
   * @return  bool
   */
  public static function set_stats_categories( $categories )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'stats_categories', $categories );
  }

/**
   * Return categories array
   *
   * @return  array   categories
   */
  public static function get_categories_array()
  {
    $general_categories       = Sendgrid_Tools::get_categories();
    $stats_categories         = Sendgrid_Tools::get_stats_categories();
    $general_categories_array = $general_categories? explode( ',', trim( $general_categories ) ):array();
    $stats_categories_array   = $stats_categories? explode( ',', trim( $stats_categories ) ):array();
    return array_unique( array_merge( $general_categories_array, $stats_categories_array ) );
  }

/**
   * Return template from the database or global variable
   *
   * @return  mixed  template string, false if the value is not found
   */
  public static function get_template()
  {
    if ( defined( 'SENDGRID_TEMPLATE' ) ) {
      return SENDGRID_TEMPLATE;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'template' );
    }
  }

/**
   * Sets the template in the database
   *
   * @param   type  string  $template
   *
   * @return  bool
   */
  public static function set_template( $template )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'template', $template );
  }

/**
   * Return content type from the database or global variable
   *
   * @return  mixed  content_type string, false if the value is not found
   */
  public static function get_content_type()
  {
    if ( defined( 'SENDGRID_CONTENT_TYPE' ) ) {
      return SENDGRID_CONTENT_TYPE;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'content_type' );
    }
  }

/**
   * Sets the unsubscribe group in the database
   *
   * @param   type  string  $unsubscribe_group
   *
   * @return  bool
   */
  public static function set_unsubscribe_group( $unsubscribe_group )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'unsubscribe_group', $unsubscribe_group );
  }

/**
   * Return unsubscribe group from the database or global variable
   *
   * @return  mixed  unsubscribe group string, false if the value is not found
   */
  public static function get_unsubscribe_group()
  {
    if ( defined( 'SENDGRID_UNSUBSCRIBE_GROUP' ) ) {
      return SENDGRID_UNSUBSCRIBE_GROUP;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'unsubscribe_group' );
    }
  }

/**
   * Set asm_permission value in db
   *
   * @param   type  string  $permission
   *
   * @return  bool
   */
  public static function set_asm_permission( $permission )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'asm_permission', $permission );
  }

/**
   * Get asm_permission value from db
   *
   * @return  mixed  asm_permission value
   */
  public static function get_asm_permission()
  {
    return Sendgrid_Tools::get_sendgrid_option( 'asm_permission' );
  }

/**
   * Returns the unsubscribe groups from SendGrid
   *
   * @return  mixed   an array of groups if the request is successful, false otherwise.
   */
  public static function get_all_unsubscribe_groups()
  {
    $url = 'v3/asm/groups';

if ( 'true' != self::get_asm_permission() ) {
      return false;
    }

$response = Sendgrid_Tools::do_request( $url );

if ( ! $response ) {
      return false;
    }

$response = json_decode( $response, true );
    if ( isset( $response['error'] ) or ( isset( $response['errors'] ) and isset( $response['errors'][0]['message'] ) ) ) {
      return false;
    }

return $response;
  }

/**
   * Sets the content-type in the database
   *
   * @param   type  string  $content_type
   *
   * @return  bool
   */
  public static function set_content_type( $content_type )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'content_type', $content_type );
  }

/**
   * Sets email label in the database
   *
   * @param   type  string  $email_label
   *
   * @return  bool
   */
  public static function set_mc_email_label( $email_label )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_email_label', $email_label );
  }

/**
   * Return email label from the database or global variable
   *
   * @return  mixed   email, false if the value is not found
   */
  public static function get_mc_email_label()
  {
    if ( defined( 'SENDGRID_MC_EMAIL_LABEL' ) ) {
      return SENDGRID_MC_EMAIL_LABEL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_email_label' );
    }
  }

/**
   * Sets first name label in the database
   *
   * @param   type  string  $first_name_label
   *
   * @return  bool
   */
  public static function set_mc_first_name_label( $first_name_label )
  {
      return Sendgrid_Tools::update_sendgrid_option( 'mc_first_name_label', $first_name_label );
  }

/**
   * Return first name label from the database or global variable
   *
   * @return  mixed   label, false if the value is not found
   */
  public static function get_mc_first_name_label()
  {
    if ( defined( 'SENDGRID_MC_FIRST_NAME_LABEL' ) ) {
      return SENDGRID_MC_FIRST_NAME_LABEL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_first_name_label' );
    }
  }

/**
   * Sets last name label in the database
   *
   * @param   type  string  $last_name_label
   *
   * @return  bool
   */
  public static function set_mc_last_name_label( $last_name_label )
  {
      return Sendgrid_Tools::update_sendgrid_option( 'mc_last_name_label', $last_name_label );
  }

/**
   * Return last name label from the database or global variable
   *
   * @return  mixed   label, false if the value is not found
   */
  public static function get_mc_last_name_label()
  {
    if ( defined( 'SENDGRID_MC_LAST_NAME_LABEL' ) ) {
      return SENDGRID_MC_LAST_NAME_LABEL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_last_name_label' );
    }
  }

/**
   * Sets subscribe label in the database
   *
   * @param   type  string  $subscribe_label
   *
   * @return  bool
   */
  public static function set_mc_subscribe_label( $subscribe_label )
  {
    return Sendgrid_Tools::update_sendgrid_option( 'mc_subscribe_label', $subscribe_label );
  }

/**
   * Return subscribe label from the database or global variable
   *
   * @return  mixed   label, false if the value is not found
   */
  public static function get_mc_subscribe_label()
  {
    if ( defined( 'SENDGRID_MC_SUBSCRIBE_LABEL' ) ) {
      return SENDGRID_MC_SUBSCRIBE_LABEL;
    } else {
      return Sendgrid_Tools::get_sendgrid_option( 'mc_subscribe_label' );
    }
  }

/**
   * Sets input padding in the database
   *
   * @param   type  string  $position
   * @param   type  int     $value
   *
   * @return  bool
   */
  public static function set_mc_input_padding( $position, $value = 0 )
  {
    if ( "" == $value ) {
      $value = 0;
    }
    $values = json_decode( self::get_mc_input_padding(), true ) ;
    if ( !isset( $values ) or !is_array($values) ) {
      $values = array(
        'top'     => 10,
        'right'   => 0,
        'bottom'  => 0,
        'left'    => 0
      );
    }

// set the new value
    $values[$position] = $value;

return Sendgrid_Tools::update_sendgrid_option( 'mc_input_padding', json_encode( $values ) );
  }

/**
   * Return input padding by from the database
   *
   * @return  mixed   json with the padding value, false if the value is not found
   */
  public static function get_mc_input_padding()
  {
    return Sendgrid_Tools::get_sendgrid_option( 'mc_input_padding' );
  }

/**
   * Return input padding by position from the database
   *
   * @param   string    $position       position
   * @return  integer                   padding value
   */
  public static function get_mc_input_padding_by_position( $position )
  {
    $padding = Sendgrid_Tools::get_sendgrid_option( 'mc_input_padding' );

if ( false == $padding ) {
      if ( $position == "top" ) {
        return 10;
      }

return 0;
    }
    $padding = json_decode( $padding, true );
    if ( !isset( $padding[$position] ) ) {
      return 0;
    }

return $padding[$position];
  }

/**
   * Sets button padding in the database
   *
   * @param   type  string  $position
   * @param   type  int     $value
   *
   * @return  bool
   */
  public static function set_mc_button_padding( $position, $value = 0 )
  {
    if ( "" == $value ) {
      $value = 0;
    }
    $values = json_decode( self::get_mc_button_padding(), true );
    if ( !isset( $values ) or !is_array($values) ) {
      $values = array(
        'top'     => 10,
        'right'   => 0,
        'bottom'  => 0,
        'left'    => 0
      );
    }

// set the new value
    $values[$position] = $value;

return Sendgrid_Tools::update_sendgrid_option( 'mc_button_padding', json_encode( $values ) );
  }

/**
   * Return button padding by from the database
   *
   * @return  mixed   json with the padding value, false if the value is not found
   */
  public static function get_mc_button_padding()
  {
    return Sendgrid_Tools::get_sendgrid_option( 'mc_button_padding' );
  }

/**
   * Return button padding by position from the database
   *
   * @param   string    $position   position
   * @return  integer               padding value
   */
  public static function get_mc_button_padding_by_position( $position )
  {
    $padding = Sendgrid_Tools::get_sendgrid_option( 'mc_button_padding' );

if ( false == $padding ) {
      if ( $position == "top" )
      {
        return 10;
      }

return 0;
    }
    $padding = json_decode( $padding, true );
    if ( !isset( $padding[$position] ) ) {
      return 0;
    }

return $padding[$position];
  }

/**
   * Check apikey stats permissions
   *
   * @param   string  $apikey        sendgrid apikey
   * @param   bool    $clear_cache   true to not use cache
   *
   * @return  bool
   */
  public static function check_api_key_stats( $apikey, $clear_cache = false )
  {
    // clear cache
    if ( $clear_cache ) {
      self::set_transient_sendgrid( self::CHECK_API_KEY_STATS_CACHE_KEY, null );
    }

// get info from cache
    $valid_apikey_stats = self::get_transient_sendgrid( self::CHECK_API_KEY_STATS_CACHE_KEY );

if ( self::VALID_CREDENTIALS_STATUS == $valid_apikey_stats ) {
      return true;
    }

$required_scopes = array( 'stats.read', 'categories.stats.read', 'categories.stats.sums.read' );

$check_scopes = Sendgrid_Tools::check_api_key_scopes( $apikey, $required_scopes );

// set cache
    if ( $check_scopes ) {
      self::set_transient_sendgrid( self::CHECK_API_KEY_STATS_CACHE_KEY, self::VALID_CREDENTIALS_STATUS, 2 * 60 * 60 );
    }

return $check_scopes;
  }

/**
   * Check apikey marketing campaigns permissions
   *
   * @param   string  $apikey   sendgrid apikey
   *
   * @return  bool
   */
  public static function check_api_key_mc( $apikey )
  {
    $required_scopes = array( 'marketing_campaigns.create', 'marketing_campaigns.read', 'marketing_campaigns.update', 'marketing_campaigns.delete' );

return Sendgrid_Tools::check_api_key_scopes( $apikey, $required_scopes );
  }

/**
   * Returns true if the email is valid, false otherwise
   *
   * @return bool
   */
  public static function is_valid_email( $email )
  {
    if ( filter_var( $email, FILTER_VALIDATE_EMAIL ) and ( SendGrid_ThirdParty::is_email( $email ) ) ) {
      return true;
    }

return false;
  }

/**
   * Returns true if all the emails in the headers are valid, false otherwise
   *
   * @param   mixed  $headers   string or array of headers
   *
   * @return  bool
   */
  public static function valid_emails_in_headers( $headers )
  {
    if ( ! is_array( $headers ) ) {
      // Explode the headers out, so this function can take both
      // string headers and an array of headers.
      $tempheaders = explode( "\n", str_replace( "\r\n", "\n", $headers ) );
    } else {
      $tempheaders = $headers;
    }

// If it's actually got contents
    if ( ! empty( $tempheaders ) ) {
      // Iterate through the raw headers
      foreach ( (array) $tempheaders as $header ) {
        if ( false === strpos( $header, ':' ) ) {
          continue;
        }
        // Explode them out
        list( $name, $content ) = explode( ':', trim( $header ), 2 );

// Cleanup crew
        $name    = trim( $name );
        $content = trim( $content );

switch ( strtolower( $name ) ) {
          // Mainly for legacy -- process a From: header if it's there
          case 'from':
            if ( false !== strpos( $content, '<' ) ) {
              $from_email = substr( $content, strpos( $content, '<' ) + 1 );
              $from_email = str_replace( '>', '', $from_email );
              $from_email = trim( $from_email );
            } else {
              $from_email = trim( $content );
            }

if( ! Sendgrid_Tools::is_valid_email( $from_email ) ) {
              return false;
            }

break;
          case 'cc':
            $cc = explode( ',', $content );
            foreach ( $cc as $key => $recipient ) {
              if( ! Sendgrid_Tools::is_valid_email( trim( $recipient ) ) ) {
                return false;
              }
            }

break;
          case 'bcc':
            $bcc = explode( ',', $content );
            foreach ( $bcc as $key => $recipient ) {
              if( ! Sendgrid_Tools::is_valid_email( trim( $recipient ) ) ) {
                return false;
              }
            }

break;
          case 'reply-to':
            if( ! Sendgrid_Tools::is_valid_email( $content ) ) {
              return false;
            }

break;
          case 'x-smtpapi-to':
            $xsmtpapi_tos = explode( ',', trim( $content ) );
            foreach ( $xsmtpapi_tos as $xsmtpapi_to ) {
              if( ! Sendgrid_Tools::is_valid_email( trim( $xsmtpapi_to ) ) ) {
                return false;
              }
            }

break;
          default:
            break;
        }
      }
    }

return true;
  }

/**
   * Returns the string content of the input with "<url>" replaced by "url"
   *
   * @return  string
   */
  public static function remove_all_tag_urls( $content )
  {
    return preg_replace('/<(https?:\/\/[^>]*)>/im', '$1', $content);
  }

/**
   * Set/update the value of a transient using database.
   *
   * @param string $transient  Transient name. Expected to not be SQL-escaped. Must be
   *                           172 characters or fewer in length.
   * @param mixed  $value      Transient value. Must be serializable if non-scalar.
   *                           Expected to not be SQL-escaped.
   * @param int    $expiration Optional. Time until expiration in seconds. Default 0 (no expiration).
   * @return bool False if value was not set and true if value was set.
   */
  public static function set_transient_sendgrid( $transient, $value, $expiration = 0 ) {
    $old_cache_value = wp_using_ext_object_cache();
    wp_using_ext_object_cache( false );

if ( ! is_multisite() || ( is_multisite() and ! is_main_site() and get_option( 'sendgrid_can_manage_subsite' ) ) ) {
      $set_transient_result = set_transient( $transient, $value, $expiration );
    } else {
      $set_transient_result = set_site_transient( $transient, $value, $expiration );
    }

wp_using_ext_object_cache( $old_cache_value );

return $set_transient_result;
  }

/**
   * Get the value of a transient from database.
   *
   * If the transient does not exist, does not have a value, or has expired,
   * then the return value will be false.
   *
   * @param string $transient Transient name. Expected to not be SQL-escaped.
   * @return mixed Value of transient.
   */
  public static function get_transient_sendgrid( $transient ) {
    $old_cache_value = wp_using_ext_object_cache();
    wp_using_ext_object_cache( false );

if ( ! is_multisite() || ( is_multisite() and ! is_main_site() and get_option( 'sendgrid_can_manage_subsite' ) ) ) {
      $value = get_transient( $transient );
    } else {
      $value = get_site_transient( $transient );
    }

wp_using_ext_object_cache( $old_cache_value );

return $value;
  }

/**
   * Function that outputs the XSS sanitized string of the current request URI,
   *  this is used in all plugin settings forms.
   *
   * @return string XSS sanitized form action attribute
   */
  public static function get_form_action() {
    // Get the original query string
    $original_query_string = $_SERVER['QUERY_STRING'];
    parse_str( $original_query_string, $get_params );
    $count_of_parameters = count( $get_params );

// No get parameters are set
    if ( ! count( $get_params ) ) {
      return $_SERVER['REQUEST_URI'];
    }

// Perform sanitization for XSS
    $sanitized_query_string = '';
    $current_parameter_count = 0;

foreach ( $get_params as $key => $value ) {
      $value = urldecode( $value );
      $value = htmlspecialchars( $value );
      $value = urlencode( $value );
      $sanitized_query_string .= $key . '=' . $value;

// Append & if it's not the last element
      if ( ++$current_parameter_count !== $count_of_parameters ) {
        $sanitized_query_string .= '&';
      }
    }

$request_uri = str_replace( $original_query_string, $sanitized_query_string, $_SERVER['REQUEST_URI'] );
    // This might be redundant, but certain online url encoders omit the ~ character when encoding
    $request_uri = str_replace( '%7E', '~', $request_uri );
    return $request_uri;
  }

/**
   * Function that returns an array of data used on the multisite pagination,
   *  The array will contain the total number of pages, the current page and
   *  HTML for the previous and next buttons.
   *
   * @param   type  int     $offset
   * @param   type  int     $limit
   *
   * @return array  data used by the multisite view
   */
  public static function get_multisite_pagination( $offset, $limit ) {
    $pagination = array();

// Fetch sites based on pagination
    $total_site_count = get_blog_count();
    $sites_remaining  = $total_site_count - $offset - $limit;

$total_page_count = 1;
    $current_page     = 1;

if ( $limit != 0 ) {
        $total_page_count = ceil( $total_site_count / $limit );
        $current_page     = ceil( $offset / $limit ) + 1;
    }

// Create previous button HTML code
    $previous_button = '';
    if ( $offset != 0 and $limit != 0 ) {
        $previous_offset = ( $offset - $limit < 0 ? 0 : $offset - $limit );
        $previous_button .= '<a href="?page=sendgrid-settings&tab=multisite&offset=' . $previous_offset;
        $previous_button .= '&limit=' . $limit . '" class="sendgrid-multisite-button button button-secondary">';
        $previous_button .= translate( 'Previous' ) . '</a>';
    }

$next_button = '';
    if ( $sites_remaining > 0 and $limit != 0 ) {
        $next_offset = $offset + $limit;
        $next_button .= '<a href="?page=sendgrid-settings&tab=multisite&offset=' . $next_offset;
        $next_button .= '&limit=' . $limit . '" class="sendgrid-multisite-button button button-secondary">';
        $next_button .= translate( 'Next' ) . '</a>';
    }

$pagination['total_pages']      = $total_page_count;
    $pagination['current_page']     = $current_page;
    $pagination['previous_button']  = $previous_button;
    $pagination['next_button']      = $next_button;

return $pagination;
  }

/**
   * Returns configured timeout for API requests
   *
   * @return  integer   timeout in seconds
   */
  public static function get_request_timeout()
  {
    if ( defined( 'SENDGRID_REQUEST_TIMEOUT' ) ) {
      return SENDGRID_REQUEST_TIMEOUT;
    } else {
      return self::DEFAULT_TIMEOUT;
    }
  }
}

/**
 * Function that registers the SendGrid plugin widgets
 *
 * @return void
 */
function register_sendgrid_widgets() {
  register_widget( 'SendGrid_NLVX_Widget' );
}

/**
 * Function that unregisters the SendGrid plugin widgets
 *
 * @return void
 */
function unregister_sendgrid_widgets() {
  unregister_widget( 'SendGrid_NLVX_Widget' );
}

/**
 * Function that outputs the SendGrid widget notice
 *
 * @return void
 */
function sg_subscription_widget_admin_notice() {
  if( ! current_user_can('manage_options') ) {
    return;
  }

echo '<div class="notice notice-success">';
  echo '<p>';
  echo _e( 'Check out the new SendGrid Subscription Widget! See the SendGrid Plugin settings page in order to configure it.' );
  echo '<form method="post" id="sendgrid_mc_email_form" class="mc_email_form" action="#">';
  echo '<input type="hidden" name="sg_dismiss_widget_notice" id="sg_dismiss_widget_notice" value="true"/>';
  echo '<input type="submit" id="sendgrid_mc_email_submit" value="Dismiss this notice" style="padding: 0!important; font-size: small; background: none; border: none; color: #0066ff; text-decoration: underline; cursor: pointer;" />';
  echo '</form>';
  echo '</p>';
  echo '</div>';
}

[-] class-sendgrid-nlvx.php [edit]
[+] sendgrid
[+] ..
[+] integration
[-] class-sendgrid-virtual-pages.php [edit]
[-] class-sendgrid-nlvx-widget.php [edit]
[-] class-sendgrid-tools.php [edit]
[-] class-sendgrid-filters.php [edit]
[-] class-sendgrid-mc-optin.php [edit]
[-] class-sendgrid-statistics.php [edit]
[-] class-sendgrid-settings.php [edit]