Campaign Showcase

The Campaign Showcase block lets you display fundraising campaigns in a modern, interactive layout with filtering, sorting, search, and optional carousel or grid – all without leaving the Block Editor. It is built on the same [campaigns] shortcode and shares all of its enhanced parameters (Charitable Pro 1.8.13+).

सामग्री तालिका

Requirements
शुरुआत करना
Block Settings (Editor)
Layouts
Interactive Features
Pagination and Navigation
Styling and Typography
Ambassadors (Peer-to-Peer)
Shortcode Reference
Examples
Troubleshooting
Developer Resources

Requirements

Charitable Pro: Version 1.8.13 or higher
WordPress: Version 6.2 or higher
PHP: Version 7.4 or higher

The Campaign Showcase block is available in the Block Editor (Gutenberg). It uses the same backend as the [campaigns] shortcode; any parameter supported by the shortcode for Campaign Showcase features can also be used when embedding via shortcode.

शुरुआत करना

Edit a page or post in the Block Editor.
Add a block and search for Campaign Showcase (or Charitable).
Insert the Campaign Showcase block.
Use the Campaign Settings, Display Settings, Interactive Features, and Search and Sorting panels in the block’s sidebar to configure which campaigns appear and how they look and behave.

The block renders a live preview in the editor. On the frontend, it outputs the same [campaigns] shortcode with the options you chose, so behavior and styling match.

Key Benefits

No shortcode syntax: Configure everything via the block’s sidebar.
Live preview: See changes immediately in the editor.
AJAX-powered: Filtering, sorting, search, and pagination work without page reloads.
Carousel or grid: Switch layouts from the sidebar.
Fully themeable: Color, typography, and spacing controls built in.

Block Settings (Editor)

All settings below are available in the block sidebar when the Campaign Showcase block is selected. Each group corresponds to a collapsible panel.

Campaign Settings

Controls which campaigns are fetched and how they are ordered.

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
अभियानों की संख्या	`number`	site default	How many campaigns to display. Use -1 for all.
Order by	`orderby`	`post_date`	Sort field: `post_date`, `post_title`, `post_modified`, `rand`, `menu_order`, `closest_to_goal`, `number_donations`, `donation_amount`
Order	`order`	`DESC`	Sort direction: `ASC` or `DESC`
Campaign IDs	`id`	–	Comma-separated campaign IDs to display specific campaigns only
श्रेणी	`category`	–	Comma-separated campaign category slugs to include
Tag	`tag`	–	Comma-separated campaign tag slugs to include
स्थिति	`status`	–	Filter by status: `active`, `finished`, or leave blank for all
Exclude	`exclude`	–	Comma-separated campaign IDs to exclude
Parent campaigns only	`parent_only`	`false`	Show only top-level (parent) campaigns
Child campaigns of	`parent_campaigns`	–	Comma-separated parent campaign IDs – shows only their child campaigns
Creator	`creator`	–	Filter to campaigns by a specific creator user ID
Include inactive	`include_inactive`	`false`	Include campaigns that are not currently active

Display Settings

Controls how each campaign card looks.

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
Layout	`layout`	grid	Layout style: leave blank for default grid, `card` for card layout, `carousel` for carousel
Columns	`columns`	`2`	Number of columns in the grid
बटन	`बटन`	`donate`	Button mode: `donate` (go to donation page), `modal` (open modal overlay), `view` (view campaign), or `hide`
Button text	`button_text`	–	Override the default donate button label
Show View Campaign button	`show_view_button`	`false`	Show a secondary View Campaign button alongside the donate button
View button text	`view_button_text`	–	Override the default view button label
Description length	`description_limit`	`100`	Maximum characters of campaign description to show
Image height	`image_height`	–	Fixed height in pixels for campaign thumbnail images
Title over image	`title_over_image`	`false`	Display the campaign title overlaid on the thumbnail image
Zoom image on hover	`image_hover_zoom`	`false`	Zoom thumbnail image on hover
Donation display	`donation_display`	`amount_goal`	How to display donation totals: `amount_goal`, `amount_only`, `goal_only`, or `none`
Show progress bar	`show_progress_bar`	`सत्य`	Show the donation progress bar
Show creator	`show_creator`	`false`	Show the campaign creator’s name
Show parent link	`show_parent_link`	`false`	Show a link to the parent campaign (for fundraisers)
Show campaign type	`show_campaign_type`	`false`	Show the campaign type label
Show fundraiser count	`show_fundraiser_count`	`false`	Show the number of fundraisers on the campaign
Show aggregated stats	`show_aggregated_stats`	`false`	Show donation stats aggregated across child campaigns
Show fundraise button	`show_fundraise_button`	`false`	Show a Start Fundraising button on each card
Show tags	`show_tags`	`false`	Display campaign taxonomy tags on each card
Show badges	`show_badges`	`सत्य`	Master toggle – show or hide all urgency badges
Show time badge	`show_time_badge`	`सत्य`	Badge showing time remaining until campaign end
Show funding badge	`show_funding_badge`	`सत्य`	Badge showing funding status (for example, Funded!)
Show donations badge	`show_donations_badge`	`false`	Badge showing total amount raised
Show donation count badge	`show_donations_count_badge`	`false`	Badge showing number of donations received
Show donors badge	`show_donors_badge`	`false`	Badge showing total unique donor count
Show quick donate	`show_quick_donate`	`false`	Show pre-selected donation amount buttons on each card
Quick donate prefix	`quick_donate_prefix`	–	Text prefix for each amount button (for example, `Give` renders “Give $25”)

Carousel (when layout is Carousel)

These settings only apply when Layout is set to Carousel.

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
Visible slides	`carousel_slides`	`3`	Number of slides visible at once
Autoplay	`carousel_autoplay`	`false`	Auto-advance slides
Autoplay speed	`carousel_speed`	`5000`	Auto-advance interval in milliseconds
Navigation position	`carousel_nav_position`	`inside`	Arrow position: `inside`, `outside`, or `none`

Interactive Features

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
Show search	`show_search`	`false`	Show a keyword search box above the campaign grid
Show sort dropdown	`show_sort`	`false`	Show a sort dropdown above the grid
Sort options	`sort_options`	–	Comma-separated list of sort options to show. Available: `post_date`, `post_title`, `donation_amount`, `closest_to_goal`, `number_donations`

Search and Sorting

See Interactive Features above. Search and sort controls appear above the campaign grid and update results via AJAX without a page reload.

Pagination and Navigation

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
Enable pagination	`pagination`	`false`	Enable pagination
Pagination type	`pagination_type`	`numbered`	Style: `numbered` or `load_more`
Pagination position	`pagination_position`	`bottom`	Where to show pagination: `top`, `bottom`, or `both`
Show prev / next	`pagination_prev_next`	`सत्य`	Show Previous and Next links in numbered pagination
Show first / last	`pagination_first_last`	`सत्य`	Show First and Last links in numbered pagination
Page range	`pagination_mid_size`	`2`	Number of page links to show around the current page

Filter Settings (which campaigns)

सेटिंग	Shortcode Parameter	डिफ़ॉल्ट	Description
Show filter pills	`show_filters`	`false`	Show category and tag filter pills above the grid
Filter types	`filter_types`	`category,tag`	Which taxonomies to show as pills: `category`, `tag`, or both
Filter limit	`filter_limit`	`15`	Maximum number of pills to show per taxonomy
Filter order by	`filter_orderby`	`count`	How to order pills: `count`, `name`, or `slug`
Filter order	`filter_order`	`DESC`	Filter pill sort direction: `ASC` or `DESC`

Colors

All color settings accept hex, rgb, rgba, or any valid CSS color value. When set via the block, they are output as inline CSS custom properties on the campaign loop wrapper. You can also set them directly via shortcode or override them in CSS.

सेटिंग	Shortcode Parameter	Description
Primary color	`color_primary`	Primary accent color (affects highlights and active states)
Background	`color_background`	Card background color
Border	`color_border`	Card border color
Text	`color_text`	General text color
Button background	`color_button`	Donate button background color
Button text	`color_button_text`	Donate button text color
View button background	`color_view_button`	View Campaign button background color
View button text	`color_view_button_text`	View Campaign button text color
Title color	`color_title`	Campaign title text color
Progress bar fill	`color_progress_bar`	Filled portion of the progress bar
Progress bar background	`color_progress_bg`	Empty (background) portion of the progress bar

Typography

All font size values accept a plain number (interpreted as pixels) or any valid CSS length (for example, 1.2rem, 18px).

सेटिंग	Shortcode Parameter	Description
Title font size	`font_size_title`	Campaign title font size
Description font size	`font_size_desc`	Campaign description text font size
Button font size	`font_size_button`	Donate and view button font size
Badge font size	`font_size_badge`	Urgency badge text font size
Amount font size	`font_size_amount`	Donation amount text font size
Stats font size	`font_size_stats`	Donation stats text font size
Title font weight	`font_weight_title`	Campaign title font weight (for example, `400`, `600`, `bold`)

Spacing and Borders

Values accept a plain number (pixels) or any valid CSS length.

सेटिंग	Shortcode Parameter	Description
Card padding	`card_padding`	Inner padding of each campaign card
Card gap	`card_gap`	Space between cards in the grid
Card border radius	`card_border_radius`	Rounded corner radius on each card
Image border radius	`image_border_radius`	Rounded corner radius on campaign thumbnail images
Border width	`border_width`	Card border thickness
Box shadow	`box_shadow`	Card box shadow (accepts any valid CSS box-shadow value)

Ambassadors (Peer-to-Peer)

When the Charitable Ambassadors extension is active, additional settings appear to control peer-to-peer fundraising display. These use the parent_only, parent_campaigns, show_fundraiser_count, show_aggregated_stats, and show_fundraise_button parameters documented above.

Layouts

Card Grid

The default layout displays campaigns in a responsive grid. Set layout="card" for the card variant with a more prominent image and structured content area.

[campaigns layout="card" columns="3"]

Carousel / Slider

Set layout="carousel" to display campaigns in a horizontally scrolling carousel. Combine with carousel settings to control the number of visible slides and navigation behavior.

[campaigns layout="carousel" carousel_slides="3" carousel_autoplay="true" carousel_speed="5000"]

Interactive Features

When show_search, show_sort, or show_filters is enabled, a control bar appears above the campaign grid. All interactions update the grid via AJAX without a full page reload.

Search: Filters campaigns by title keyword as the visitor types.
Sort dropdown: Lets visitors re-order campaigns by date, title, amount raised, closest to goal, or donation count.
Filter pills: Shows clickable category and tag pills. Clicking a pill filters the grid to matching campaigns only.

Multiple controls can be active simultaneously. The current state is preserved across paginated loads.

Pagination and Navigation

Pagination is disabled by default. When enabled, campaigns are split across pages based on the number setting.

Numbered: Shows page numbers with optional Previous / Next and First / Last links.
Load More: Appends the next page of campaigns below the current results when the button is clicked.

The pagination_mid_size setting controls how many page numbers appear around the current page in numbered mode. Previous / Next and First / Last links can be hidden individually using pagination_prev_next and pagination_first_last.

Styling and Typography

All visual settings (colors, font sizes, spacing) set via the block sidebar are compiled into inline CSS custom properties and applied to the campaign loop wrapper element. This means each Campaign Showcase instance on a page can have independent styling.

You can also apply the same properties via the css_variables shortcode parameter:

[campaigns css_variables="--charitable-cs-btn-bg: #e74c3c; --charitable-cs-btn-color: #ffffff;"]

Or target the wrapper in your theme CSS:

.campaign-loop {
    --charitable-cs-btn-bg: #e74c3c;
    --charitable-cs-btn-color: #ffffff;
}

Ambassadors (Peer-to-Peer)

When the Charitable Ambassadors extension is active, the Campaign Showcase supports peer-to-peer fundraising display. Use these parameters to control the experience:

parent_only="true" – Show only parent campaigns, not individual fundraiser pages.
parent_campaigns="123,456" – Show only fundraisers that are children of specific campaigns.
show_fundraiser_count="true" – Show how many fundraisers are running for each campaign.
show_aggregated_stats="true" – Roll up donation totals from all child fundraisers into the parent campaign stats.
show_fundraise_button="true" – Show a Start Fundraising button on each campaign card.

Shortcode Reference

The full [campaigns] shortcode reference. All parameters work in both the block (via the sidebar) and the classic shortcode.

Core Parameters

Parameter	प्रकार	डिफ़ॉल्ट	Description
`id`	स्ट्रिंग	–	Comma-separated campaign IDs to display only specific campaigns
`number`	पूर्णांक	site default	Number of campaigns to display. Use -1 for all.
`orderby`	स्ट्रिंग	`post_date`	Sort field: `post_date`, `post_title`, `post_modified`, `rand`, `menu_order`, `closest_to_goal`, `number_donations`, `donation_amount`
`order`	स्ट्रिंग	`DESC`	Sort direction: `ASC` or `DESC`
`category`	स्ट्रिंग	–	Comma-separated campaign category slugs to include
`tag`	स्ट्रिंग	–	Comma-separated campaign tag slugs to include
`status`	स्ट्रिंग	–	Campaign status filter: `active`, `finished`, or leave blank for all
`exclude`	स्ट्रिंग	–	Comma-separated campaign IDs to exclude
`parent_only`	बूल	`false`	Show only top-level (parent) campaigns
`parent_campaigns`	स्ट्रिंग	–	Comma-separated parent IDs – shows only their child campaigns
`creator`	स्ट्रिंग	–	Filter to campaigns created by a specific user ID
`include_inactive`	बूल	`false`	Include campaigns that are not currently active

Display Parameters

Parameter	प्रकार	डिफ़ॉल्ट	Description
`layout`	स्ट्रिंग	–	Layout style: leave blank for default grid, `card` for card layout, `carousel` for carousel
`columns`	पूर्णांक	`2`	Number of columns in the grid
`बटन`	स्ट्रिंग	`donate`	Button mode: `donate`, `modal`, `view`, or `hide`
`button_text`	स्ट्रिंग	–	Override default donate button label
`show_view_button`	बूल	`false`	Show a secondary View Campaign button
`view_button_text`	स्ट्रिंग	–	Override default view button label
`description_limit`	पूर्णांक	`100`	Maximum characters of campaign description to show
`image_height`	पूर्णांक	–	Fixed height in pixels for campaign thumbnail images
`title_over_image`	बूल	`false`	Display the campaign title overlaid on the thumbnail image
`image_hover_zoom`	बूल	`false`	Zoom thumbnail on hover
`donation_display`	स्ट्रिंग	`amount_goal`	How to display donation totals: `amount_goal`, `amount_only`, `goal_only`, or `none`
`show_progress_bar`	बूल	`सत्य`	Show the donation progress bar
`show_creator`	बूल	`false`	Show campaign creator name
`show_parent_link`	बूल	`false`	Show link to parent campaign (for fundraisers)
`show_campaign_type`	बूल	`false`	Show campaign type label
`show_fundraiser_count`	बूल	`false`	Show number of fundraisers
`show_aggregated_stats`	बूल	`false`	Show aggregated stats across child campaigns
`show_fundraise_button`	बूल	`false`	Show a Start Fundraising button
`show_tags`	बूल	`false`	Display campaign tags on each card
`css_variables`	स्ट्रिंग	–	Inline CSS custom properties applied to the campaign loop wrapper

Badge Parameters

Parameter	प्रकार	डिफ़ॉल्ट	Description
`show_badges`	बूल	`सत्य`	Master toggle – show or hide all urgency badges
`show_time_badge`	बूल	`सत्य`	Badge showing time remaining until campaign end
`show_funding_badge`	बूल	`सत्य`	Badge showing funding status
`show_donations_badge`	बूल	`false`	Badge showing total amount raised
`show_donations_count_badge`	बूल	`false`	Badge showing number of donations received
`show_donors_badge`	बूल	`false`	Badge showing total unique donor count

Quick Donate Parameters

Quick donate renders pre-selected donation amount buttons directly on the campaign card.

Parameter	प्रकार	डिफ़ॉल्ट	Description
`show_quick_donate`	बूल	`false`	Enable quick donate buttons on cards
`quick_donate_prefix`	स्ट्रिंग	–	Text prefix for each amount button (for example, `Give` renders “Give $25”)

When button="modal", clicking an amount button opens the modal with that amount pre-selected. When button="donate", clicking an amount button navigates to the donation page with the amount pre-filled. If no suggested amounts are configured, a custom amount input is shown instead.

Carousel Parameters

Only apply when layout="carousel".

Parameter	प्रकार	डिफ़ॉल्ट	Description
`carousel_slides`	पूर्णांक	`3`	Number of slides visible at once
`carousel_autoplay`	बूल	`false`	Auto-advance slides
`carousel_speed`	पूर्णांक	`5000`	Auto-advance interval in milliseconds
`carousel_nav_position`	स्ट्रिंग	`inside`	Navigation arrow position: `inside`, `outside`, or `none`

Search, Sort, and Filter Parameters

Parameter	प्रकार	डिफ़ॉल्ट	Description
`show_search`	बूल	`false`	Show a keyword search box above the campaign grid
`show_sort`	बूल	`false`	Show a sort dropdown above the grid
`sort_options`	स्ट्रिंग	–	Comma-separated sort options to show. Available: `post_date`, `post_title`, `donation_amount`, `closest_to_goal`, `number_donations`
`show_filters`	बूल	`false`	Show category and tag filter pills
`filter_types`	स्ट्रिंग	`category,tag`	Which taxonomies to show as pills: `category`, `tag`, or both
`filter_limit`	पूर्णांक	`15`	Maximum number of pills to show per taxonomy
`filter_orderby`	स्ट्रिंग	`count`	How to order pills: `count`, `name`, or `slug`
`filter_order`	स्ट्रिंग	`DESC`	Filter pill sort direction: `ASC` or `DESC`

Pagination Parameters

Parameter	प्रकार	डिफ़ॉल्ट	Description
`pagination`	बूल	`false`	Enable pagination
`pagination_type`	स्ट्रिंग	`numbered`	Style: `numbered` or `load_more`
`pagination_position`	स्ट्रिंग	`bottom`	Where to show pagination: `top`, `bottom`, or `both`
`pagination_prev_next`	बूल	`सत्य`	Show Previous and Next links (numbered mode)
`pagination_first_last`	बूल	`सत्य`	Show First and Last links (numbered mode)
`pagination_mid_size`	पूर्णांक	`2`	Number of page links to show around the current page

Color Parameters

All color values accept hex, rgb, rgba, or any valid CSS color.

Parameter	प्रकार	Description
`color_primary`	स्ट्रिंग	Primary accent color
`color_background`	स्ट्रिंग	Card background color
`color_border`	स्ट्रिंग	Card border color
`color_text`	स्ट्रिंग	General text color
`color_button`	स्ट्रिंग	Donate button background
`color_button_text`	स्ट्रिंग	Donate button text color
`color_view_button`	स्ट्रिंग	View Campaign button background
`color_view_button_text`	स्ट्रिंग	View Campaign button text color
`color_title`	स्ट्रिंग	Campaign title color
`color_progress_bar`	स्ट्रिंग	Progress bar fill color
`color_progress_bg`	स्ट्रिंग	Progress bar background color

Typography Parameters

Font size values accept a plain number (pixels) or any valid CSS length (for example, 1.2rem).

Parameter	प्रकार	Description
`font_size_title`	स्ट्रिंग	Campaign title font size
`font_size_desc`	स्ट्रिंग	Description text font size
`font_size_button`	स्ट्रिंग	Button font size
`font_size_badge`	स्ट्रिंग	Badge text font size
`font_size_amount`	स्ट्रिंग	Donation amount font size
`font_size_stats`	स्ट्रिंग	Donation stats font size
`font_weight_title`	स्ट्रिंग	Title font weight (for example, `400`, `600`, `bold`)

Spacing and Border Parameters

Values accept a plain number (pixels) or any valid CSS length.

Parameter	प्रकार	Description
`card_padding`	स्ट्रिंग	Inner padding of each card
`card_gap`	स्ट्रिंग	Space between cards
`card_border_radius`	स्ट्रिंग	Card corner radius
`image_border_radius`	स्ट्रिंग	Thumbnail image corner radius
`border_width`	स्ट्रिंग	Card border thickness
`box_shadow`	स्ट्रिंग	Card box shadow (any valid CSS box-shadow value)

Examples

Basic 3-column card grid with modal donate:

[campaigns layout="card" columns="3" button="modal"]

Active campaigns sorted by closest to goal, with load-more pagination:

[campaigns status="active" orderby="closest_to_goal" number="9" pagination="true" pagination_type="load_more"]

Campaign carousel with 4 visible slides and autoplay:

[campaigns layout="carousel" carousel_slides="4" carousel_autoplay="true" carousel_speed="4000"]

With quick donate buttons and custom button color:

[campaigns show_quick_donate="true" button="modal" color_button="#e74c3c"]

With search, sort, and category filters:

[campaigns show_search="true" show_sort="true" show_filters="true" filter_types="category" columns="3"]

Specific campaigns only:

[campaigns id="12,45,67" layout="card" columns="3"]

Troubleshooting

Block or preview not showing correctly

Confirm Charitable Pro 1.8.13 or higher is active.
Deactivate other plugins temporarily to rule out a JavaScript conflict.
Check the browser console for JavaScript errors.
Try switching to a default WordPress theme (Twenty Twenty-Four) to rule out a theme conflict.

Sort / filter / search not working

Verify that the page is not served from an aggressive full-page cache that strips the data-shortcode-atts attribute from the <ol> wrapper.
The AJAX handler requires wp-admin/admin-ajax.php to be reachable. Some security plugins block this endpoint.
Check that JavaScript is enabled and no Content Security Policy is blocking inline scripts.

Carousel not sliding or arrows missing

Ensure layout="carousel" is set.
Check that the Swiper library assets are loading (look for /assets/js/libraries/swiper* in the browser network tab).
If using a caching plugin, clear the cache after saving the page.

Styling looks wrong

If colors or sizes set in the block sidebar are not appearing, clear the page cache.
Custom CSS that targets .campaign-loop selectors with !important will override the CSS custom properties set by the block. Remove conflicting rules or increase specificity.
Confirm the theme is not enqueueing a stylesheet that resets custom properties.

Developer Resources

Block and shortcode

The Campaign Showcase block is registered as charitable/campaign-showcase. It has no client-side save; it uses a server-side render callback that builds a [campaigns ...] shortcode string from block attributes and outputs it inside a block wrapper. Any attribute you set in the editor is translated to the corresponding shortcode parameter.

Hooks and filters

फ़िल्टर

charitable_campaigns_shortcode_atts – Modify the parsed shortcode attributes before display (block and shortcode).

add_filter( 'charitable_campaigns_shortcode_atts', function( $args ) {
    $args['button'] = 'modal';
    return $args;
} );

charitable_campaigns_shortcode_view_args – Modify the view arguments passed to the campaigns template (block and shortcode).

charitable_campaigns_shortcode_query_args – Modify the WP_Query arguments used to fetch campaigns (block and shortcode).

add_filter( 'charitable_campaigns_shortcode_query_args', function( $query_args, $args ) {
    $query_args['post__not_in'] = array( 42 );
    return $query_args;
}, 10, 2 );

charitable_ajax_campaign_showcase_query_args – Modify the query arguments used for Campaign Showcase AJAX requests (sort, filter, search). Apply the same exclusions here that you set in charitable_campaigns_shortcode_query_args so they persist on paginated and filtered loads.

add_filter( 'charitable_ajax_campaign_showcase_query_args', function( $args, $shortcode_atts ) {
    $args['post__not_in'] = array( 42 );
    return $args;
}, 10, 2 );

charitable_campaigns_shortcode – Modify the final HTML output of the entire campaign showcase before it is returned.

charitable_campaign_sort_options – Modify the available sort options shown in the sort dropdown.

add_filter( 'charitable_campaign_sort_options', function( $options, $args ) {
    $options['my_custom_sort'] = __( 'Featured First', 'my-plugin' );
    return $options;
}, 10, 2 );

charitable_campaign_filter_pills – Modify the filter pills array before rendering. Each element has term, count, and label keys.

charitable_show_campaign_urgency_badges – Return false to suppress all badges for a specific campaign.

add_filter( 'charitable_show_campaign_urgency_badges', function( $show, $campaign, $args ) {
    if ( $campaign->has_ended() ) {
        return false;
    }
    return $show;
}, 10, 3 );

charitable_quick_donate_url – Modify the destination URL used by non-modal quick donate buttons. Only applies when button is not modal. Return the base URL only – the ?amount=X parameter is appended automatically after this filter runs.

add_filter( 'charitable_quick_donate_url', function( $url, $campaign_id, $args ) {
    return add_query_arg(
        array( 'campaign_id' => $campaign_id ),
        home_url( '/donate/' )
    );
}, 10, 3 );

charitable_campaign_card_image_height – Modify the image height in pixels applied to campaign cards when image_height is set.

charitable_campaigns_shortcode_pagination_args – Modify the pagination arguments before the pagination HTML is generated.

charitable_campaigns_shortcode_pagination – Modify the pagination HTML string before it is output.

charitable_modal_donate_button_html – Modify the HTML of a modal donate button.

charitable_campaigns_shortcode_template – Override the template used to render the campaign loop. Return a template file path to use a custom template.

Action hooks

These hooks fire at key points during campaign loop rendering, allowing you to inject custom HTML.

charitable_campaign_loop_before – Fires immediately before the campaign loop wrapper opens.

do_action( 'charitable_campaign_loop_before', $campaigns, $args );

charitable_campaign_loop_after – Fires immediately after the campaign loop wrapper closes.

do_action( 'charitable_campaign_loop_after', $campaigns, $args );

charitable_campaign_content_loop_before – Fires at the start of each individual campaign card, before any content is output.

do_action( 'charitable_campaign_content_loop_before', $campaign, $view_args );

charitable_campaign_content_loop_before_title – Fires just before the campaign title is output inside the card.

do_action( 'charitable_campaign_content_loop_before_title', $campaign, $view_args );

charitable_campaign_content_loop_after_title – Fires just after the campaign title is output inside the card.

do_action( 'charitable_campaign_content_loop_after_title', $campaign, $view_args );

charitable_campaign_content_loop_after – Fires at the end of each individual campaign card, after all content is output.

do_action( 'charitable_campaign_content_loop_after', $campaign, $view_args );

CSS classes

.campaign-loop                    - outer list wrapper
.campaign-layout-card             - card layout modifier
.campaign-loop li                 - individual campaign item
.campaign-thumbnail               - image wrapper
.campaign-title                   - campaign title
.campaign-description             - description text
.campaign-donation                - donate button area
.campaign-quick-donate            - quick donate button row
.campaign-badge                   - individual urgency badge
.campaign-badge-time-remaining    - time badge
.campaign-badge-funding-status    - funding status badge
.campaign-badge-donations         - donations raised badge
.campaign-badge-donation-count    - donation count badge
.campaign-badge-donors            - donor count badge
.charitable-carousel-wrapper      - carousel outer wrapper

Version history

Version	Changes
1.8.13	Added Campaign Showcase block, card and carousel layouts, AJAX sort / filter / search / pagination, urgency badges, quick donate buttons, color / typography / spacing controls, modal donate integration, Ambassadors peer-to-peer support

दान संबंधी दस्तावेज़ीकरण

लोकप्रिय संसाधन

सामग्री तालिका

Requirements

शुरुआत करना

Key Benefits

Block Settings (Editor)

Campaign Settings

Display Settings

Carousel (when layout is Carousel)

Interactive Features

Search and Sorting

Pagination and Navigation

Filter Settings (which campaigns)

Colors

Typography

Spacing and Borders

Ambassadors (Peer-to-Peer)

Layouts

Card Grid

Carousel / Slider

Interactive Features

Pagination and Navigation

Styling and Typography

Ambassadors (Peer-to-Peer)

Shortcode Reference

Core Parameters

Display Parameters

Badge Parameters

Quick Donate Parameters

Carousel Parameters

Search, Sort, and Filter Parameters

Pagination Parameters

Color Parameters

Typography Parameters

Spacing and Border Parameters

Examples

Troubleshooting

Block or preview not showing correctly

Sort / filter / search not working

Carousel not sliding or arrows missing

Styling looks wrong

Developer Resources

Block and shortcode

Hooks and filters

CSS classes

Version history

चैरिटेबल में नया क्या है

ईमेल सदस्यता

हमारे न्यूज़लेटर में शामिल हों

GiveWP के लिए व्हाइट ग्लोव माइग्रेशन सेवा

📢 नई सुविधा अलर्ट: ऑटोमेशन कनेक्ट 2.0 यहाँ है! 🚀

🔌 चैरिटेबल ज़ैपियर से जुड़ता है: 7,000+ ऐप्स से कनेक्ट करें और अपने धन उगाहने को स्वचालित करें

🚀 पेपैल कॉमर्स का परिचय: एक कनेक्शन, दान करने के छह तरीके

⏳ अभियान काउंटडाउन: तात्कालिकता को बढ़ाएं और दान बढ़ाएं