Documentation Category: Widgets & Shortcodes

  • Team Members Shortcode

    The [charitable_team_members] shortcode adds a grid showing a particular fundraising team’s members. Parameters team_id: Set the team’s ID. This can be left out or set to current to display the members for the campaign currently being viewed. title: Show a title before the list of team members. This is empty by default. columns: Choose how…

  • Fundraise Button Shortcode

    The [charitable_fundraise_button] shortcode adds a link or button that people can click to go to the fundraising form for a particular campaign. Parameters parent_campaign_id: Set the parent campaign’s ID. This can be left out or set to current to display the fundraise button for the campaign currently being viewed. display: Whether to display a button…

  • Submit Campaign Shortcode

    The [charitable_submit_campaign] shortcode allows you to display a campaign form on a page. Parameters Note: All of the parameters below were added in Ambassadors 2.0. If you are on a previous version, you can only use the shortcode in its default form, without any parameters. parent_id: Set a campaign parent. This means that all campaigns…

  • Stats Shortcode

    The [charitable_stat] shortcode allows you to display various Charitable statistics directly in a page. The statistics are dynamically calculated and displayed. Note: The [charitable_stat] shortcode is only available in Charitable 1.6+. Parameters display: The type of data to display. The choices are: total – The amount that has been raised. This is the default option. progress – How…

  • Donors Widget

    Display a list of donors. This can be used to show donors for a specific campaign or for all campaigns. To manage your widgets, log into your WordPress Dashboard and go to Appearance > Customize. Open up the Widgets panel (in certain themes, this panel may be named something else) and add the Donors widget. Available options: Title: The…

  • Donation Stats Widget

    Display a simple widget to show the number of campaigns, amount donated and number of donors. To manage your widgets, log into your WordPress Dashboard and go to Appearance > Customize. Open up the Widgets panel (in certain themes, this panel may be named something else) and add the Donation Stats widget. Available options: Title: The widget title to…

  • Campaign Categories/Tags Widget

    Display a list of your campaign categories or tags. To manage your widgets, log into your WordPress Dashboard and go to Appearance > Customize. Open up the Widgets panel (in certain themes, this panel may be named something else) and add the Campaign Categories/Tags widget. Available options: Title: The widget title to be displayed at the top of the…

  • Campaign Donation Widget

    Display a simple donation widget in your sidebar. Your donors choose their donation amount and are redirected to the campaign donation page to finalize their donation. To manage your widgets, log into your WordPress Dashboard and go to Appearance > Customize. Open up the Widgets panel (in certain themes, this panel may be named something else) and add the Campaign…

  • Campaigns Widget

    You can display a list of campaigns with the Campaigns widget. To manage your widgets, log into your WordPress Dashboard and go to Appearance > Customize. Open up the Widgets panel (in certain themes, this panel may be named something else) and add the Campaigns widget. Available options: Title: The title of your widget. This may be left…

  • Add Your Donation Form to a Page

    With Charitable 1.5, there is an easy way to embed a donation form in a page with the [charitable_donation_form] shortcode. Simply create your campaign (if you’re not sure how, see this documentation), then find the ID of the campaign by going to Charitable > Campaigns. You will see the ID listed before the campaign name. Now…

  • Donors Shortcode

    The [charitable_donors] shortcode allows you to display a list of donors to one or all of your campaigns on a page. It uses the same frontend template as the Donors widget, so its output is similar — it just provides you with flexibility to show the Donors in different spots. Parameters number Number of donors to…

  • Account Shortcodes

    Table of Contents Login form Logout link Registration form Profile form Donations table Login Form To set it up, add the following shortcode to a new page: [charitable_login] You can optionally set the message that will be displayed to users when they are already logged in with the logged_in_message parameter: [charitable_login logged_in_message=”You are already logged in!”] You…

  • Campaigns Shortcode

    The [campaigns] shortcode allows you to display a collection of campaigns within your posts or pages. Parameters number: The number of campaigns to show. Set this to -1 to show all campaigns. Defaults to the number of posts you show on blog pages. orderby: The order in which campaigns are displayed. Options include post_date, popular and ending.…