Resolving the "form" query parameter conflict

General troubleshooting steps

Problem description

Fundraise Up’s checkout relies on various query parameters, including form, member, fundraiser, and element. When a website reserves or utilizes these parameters for other purposes, it could obstruct the checkout display and sometimes result in background webpage changes when launching the checkout.

Resolution steps

1. Identify the conflict
   • Utilize your website's development tools to ascertain if one of the reserved query parameters is used elsewhere on your site.
   • Engage your web developer or scrutinize your website's code to pinpoint where and how the query parameter is being used.
2. Modify your website's configuration
   • If feasible, alter the conflicting query parameter to a different term.
   • Ensure this alteration doesn’t impair other functionalities of your website.
3. Test Fundraise Up Checkout
   • Post-modification, test the Fundraise Up checkout to verify it displays and operates correctly.

WordPress-specific troubleshooting steps

In some WordPress setups, the form query parameter used by Fundraise Up can conflict with theme or plugin routing logic. As a result, opening a Checkout Modal via a direct link (for example, /?form=donate) may load an unexpected section of the site instead of the intended page.

This behavior is controlled entirely by the website’s WordPress configuration and is not set on the Fundraise Up side.

Here’s how to address this issue in a WordPress setting:

1. Plugin conflict check
   • Temporarily deactivate all plugins except for the ones necessary for Fundraise Up's installation code implementation. Then, inspect if the checkout displays correctly.
   • Reactivate your plugins one at a time, checking the checkout after each activation to identify the conflicting plugin.
2. Theme conflict check
   • Temporarily switch to a default WordPress theme, like Twenty Twenty-One, and examine the checkout again.
   • If the issue resolves, the conflict likely resides within your theme’s code.
3. Check custom code
   • Scrutinize any custom code added to your website for instances where the form query parameter might be utilized or reserved.
4. Consult with a developer
   • If unable to identify or resolve the conflict, consulting with a professional WordPress developer might be beneficial.
5. Seek plugin/theme developer support
   • If a particular plugin or theme is identified as the source of the conflict, reach out to the developer for support.

Solving WordPress form query parameter conflict in functions.php

Configure WordPress to ignore Fundraise Up–specific query parameters by adding the following function to the bottom of the active theme’s functions.php file:

1function custom_ignore_query_params( $query_vars ) {
2    $params_to_ignore = array( 'form', 'member', 'fundraiser', 'element' );
3
4    foreach ( $params_to_ignore as $param ) {
5        if ( isset( $query_vars[ $param ] ) ) {
6            unset( $query_vars[ $param ] );
7        }
8    }
9    return $query_vars;
10}
11add_filter( 'request', 'custom_ignore_query_params' );

After applying the change, clear any site caching and test the Checkout Modal link again.