Add a parameter in dashboard_url based on it it will refetch user data after rocketcdn express checkout purchase is completed

[mostafa-hisham]

We want to add a new parameter in dashboard_url as we did in Rocket Insights rocket_insights_upgrade.
Based on the new rocketcdn parameter

• The plugin will (clear a transient) refetch user data from /stat/1.0/wp-rocket/user.php, and it will return
  cdn_token, cdn_url and rocketcdn_website_id
• Do the necessary configuration of RocketCDN on the customer's website wp_ajax_rocketcdn_validate_token_cname (AI plugin uses this action)
• Call the rocketCDN API to activate PATCH /api/website/{rocketcdn_website_id}/ with:

$data = [
			'is_active' => $is_active,// true or false
		];

[Miraeld]

Scope a solution

1. Add the new parameter to dashboard_url

Similar to how Rocket Insights builds its checkout URL with rocket_insights_upgrade=true, add a RocketCDN-specific parameter (e.g. rocketcdn_checkout=true) to the dashboard URL used for express checkout.

2. Detect the parameter and validate state

When the user lands back on the settings page with this parameter:

• Guard clause: Check if RocketCDN token already exists (rocketcdn_user_token option)
  • If token exists, bail out early and redirect to clean URL (prevents duplicate activation on page refresh)
  • If no token exists, proceed with activation flow
• Flush the user data cache (delete transient wp_rocket_customer_data) so fresh data is fetched from the API
• The refetched user data will now include cdn_token, cdn_url, and rocketcdn_website_id

3. Configure RocketCDN with the new data

Using the fresh data from the API, reuse the existing logic from wp_ajax_rocketcdn_validate_token_cname (or extract into a shared private method):

• Validate token format (40 characters) and URL format
• Store the CDN token: update_option( 'rocketcdn_user_token', $token )
• Enable CDN with the URL: $this->cdn_options->enable( esc_url_raw( $cdn_url ) )

4. Activate the subscription via RocketCDN API

Call PATCH /api/website/{rocketcdn_website_id}/ with is_active: true to activate the subscription.

5. Redirect to clean URL

Redirect to the settings page without the query parameter to avoid re-triggering on refresh.

Technical Notes

• Follow the same pattern as Rocket Insights (see inc/Engine/Admin/RocketInsights/Subscriber.php::flush_license_cache())
• Consider extracting the token/URL validation and storage logic from validate_token_cname() into a reusable private method to avoid code duplication
• The guard clause in step 2 prevents unnecessary API calls if the user already has RocketCDN configured

Effort

S (implementation) / M (with full testing + API error handling)

[mostafa-hisham]

@Miraeld looks good from the add-on team side.
@wp-media/engineering-wpr-plugin-team should have a look as well.

[wordpressfan]

Thanks @Miraeld
I believe this is not S at all, can u plz recheck the effort again?

for storing CDN token and url, did u check what happens now in the code? how we save those details with the current iframe modal, we may take benefit of this part if we can.

Another thing to think of, if the user opens this link with the query string, we will bailout if the token is there in the API without the need to send the activate request again.

What do u think?

[Miraeld]

@wordpressfan I've adapted the grooming, what do you think ?

[wordpressfan]

Looks good, thanks @Miraeld

[mostafa-hisham]

@Miraeld @wp-media/qa-team
Here is the RocketCDN One Click Purchase QA document
FYI @piotrbak