Charitable Documentation

Learn how to make the most of Charitable with clear, step-by-step instructions.

Charitable Ambassadors 2.0 Upgrade Notes

If you are updating to Charitable Ambassadors 2.0 from a previous version, there are some changes you should be aware of, particularly if you are using code to customize the plugin’s behaviour.

Hooks & Filters

Some filters were removed:

  • charitable_ambassadors_shortcodes_start

The arguments passed to the following filters were changed to make them consistent:

  • charitable_campaign_submission_core_data
  • charitable_campaign_submission_user_data
  • charitable_campaign_submission_meta_data
  • charitable_campaign_submission_taxonomy_data

Each filter now receives the following arguments:

  • $data (array) – The data to be filtered.
  • $processor (Charitable_Ambassadors_Campaign_Form_Data_Processor) – The data processor object.

Deprecated

The following functions & methods were deprecated and will be removed in a future version (2.2.0 or after):

  • Charitable_Ambassadors::download_donations_csv()
    Use Charitable_Ambassadors_Campaigns::download_donations_csv()
  • Charitable_Ambassadors_Admin::register_meta_boxes()
  • Charitable_Ambassadors_Admin::admin_view_path()
  • Charitable_Ambassadors_Campaigns::get_instance()
    Use new Charitable_Ambassadors_Campaigns() instead.
  • charitable_ambassadors_register_emails()
    Use Charitable_Ambassadors_Emails::register_emails() instead.
  • charitable_ambassadors_resendable_donation_emails()
    Use Charitable_Ambassadors_Emails::set_resendable_donation_emails() instead.
  • charitable_ambassadors_add_email_shortcode_parameters()
    Use Charitable_Ambassadors_Emails::add_email_shortcode_parameters() instead.
  • Charitable_Ambassadors_Email_Creator_Campaign_Submitted::send_email()
    Use Charitable_Ambassadors_Email_Creator_Campaign_Submitted::send_with_campaign_id instead.
  • Charitable_Ambassadors_Email_New_Campaign::send_email()
    Use Charitable_Ambassadors_Email_New_Campaign::send_with_campaign_id instead.
  • Charitable_Ambassadors_Shortcodes::start()

The following methods of Charitable_Ambassadors_Campaign_Form were all deprecated, since processing of form submissions the Charitable_Ambassadors_Campaign_Form_Processor,Charitable_Ambassadors_Campaign_Form_Data_Processor and Charitable_Campaign_Processor classes.

  • Charitable_Ambassadors_Campaign_Form::save_campaign_details()
  • Charitable_Ambassadors_Campaign_Form::save_user_data()
  • Charitable_Ambassadors_Campaign_Form::save_core_campaign_data()
  • Charitable_Ambassadors_Campaign_Form::save_campaign_taxonomies()
  • Charitable_Ambassadors_Campaign_Form::save_campaign_meta()
  • Charitable_Ambassadors_Campaign_Form::save_picture()
  • Charitable_Ambassadors_Campaign_Form::get_end_date()
  • Charitable_Ambassadors_Campaign_Form::save_end_date()
  • Charitable_Ambassadors_Campaign_Form::sanitize_campaign_length()
  • Charitable_Ambassadors_Campaign_Form::set_thumbnail_id_meta_key()
  • Charitable_Ambassadors_Campaign_Form::sanitize_recurring_donations()
  • Charitable_Ambassadors_Campaign_Form::get_redirect_url()
  • Charitable_Ambassadors_Campaign_Form::set_submission_context()
  • Charitable_Ambassadors_Campaign_Form::save_submission_data()

Still have questions? We’re here to help!

Last Modified: