Overview
In an effort to make it as easy as possible to understand what’s happening when something goes wrong, we’ve built a whole bunch of URL parameters to the plugin that performs a variety of functions.
Using a URL parameter means attaching a small amount of text to the end of the URL in your browser window.
That means if your blog post is located at https://domain.com/my-blog-post/, you can simply change it to https://domain.com/my-blog-post/?parameter=something_here.
Commonly Used Parameters
The following table provides a list of all of the most common and easy to use URL parameters that can make it much easier to accomplish certain troubleshooting tasks.
Parameter | Description |
?swp_cache=rebuild | The plugin only updates the share count numbers once in a while at certain intervals. Using this parameter will update the numbers immediately as the page is being loaded. |
?swp_debug=script | The plugin normally uses minified CSS and JS files. This parameter will cause it to output the non-minified version to the screen. This will make inspecting and finding the line numbers of errors much easier. |
?swp_debug=force_new_shares | Normally, the plugin will only keep and use share counts if the fetched counts are equal to or higher than the previously fetched counts. This is because, in some instances, we’ve noticed certain networks go from tracking thousands of shares…to none. So we preserve the ones that we already fetched. This parameter forces the plugin to accept and use the new counts regardless of whether they are higher. |
?swp_debug=get_user_options | This outputs an array of all the options as set on the Social Warfare options page allowing technical staff to quickly and easily see what the user has set for each option. |
?swp_debug=get_post_meta | This outputs the values of the custom fields for a given post, allowing us to see the set share counts and the custom Social Warfare settings for that post. |
Advanced Debugging
The following parameters are for outputting data to the screen that allows you to see much more advanced and in-depth information about what certain classes are doing.
Paramter | Description |
?swp_debug=post_cache | Outputs the entire contents of the SWP_Post_Cache object. Use in conjunction with ?swp_cache=rebuild to view the raw data as it is fetched from the API’s. |
?swp_debug=json_fetch | Immediately fetches new sidebar data and components for the Social Warfare settings page. |
?swp_debug=reset_float_location | For all Pages whose float location is ‘on,’ this will reset it to ‘default.’ Optionally you can pass an post_type argument and specify a post type, such as &post_type=post , to target that post type. |