****There is a new version of this plugin available. Log in to the btwb website and go to the “WordPress Integration” Page under the gym admin menu.*****
Installation Instructions:
- Log in to BTWB and go to “WordPress Integration” in your Gym Menu
- Scroll to the bottom of the page.
- Download the plugin: Beyond the Whiteboard Plugin
- Log in to your WordPress Dashboard (e.g. “www.yoursite.com/wp-admin”)
- Click “Plugins” > “Add New”
- Click “Upload” and choose the “btwb-latest.zip” file you just downloaded.
- Click “Install Now”, then click “Activate” to activate the plugin.
- Click on WordPress “Settings” and select “BTWB Options”
- Set your Public Access Key (found on this BTWB WordPress Plugin Page)
- Specify your default settings.
Editor Buttons:
When you install the plugin, the following 3 buttons are added to your page/post editor:
You can easily insert any of the 3 shortcodes into your post by using these buttons.
Shortcodes:
These shortcodes can be inserted on any page or post in wordpress. When the page loads, the code will be replaced with the appropriate WODs, Activity, or Leaderboard from Beyond the Whiteboard. Below you can find all the possible configuration options. If you don’t set a specific option in the shortcode, it will default to whatever you have specified in your default settings.
By default,
will always display the current day, and update automatically each day. It is meant to be put on a “Today’s WOD” page that will always show the current day’s WODs. With no parameters specified, the page will display based on your default settings.Parameters:
You can use the following parameters to override your default settings. Here is an example:
-date
Specifies the date
e.g.
-sections
Select which sections to show the Workouts from
e.g.
Options: “pre,main,post,all”
-tracks
Select which tracks to show the Workouts from
e.g.
Options: “1,2,3,4”
-activity_length
Specify how many Recent Posts to display
e.g.
Options: Any number between “1” and “30”
-leaderboard_length
Specify how many top results to show. We return that many results for males, and that many for females.
e.g.
Options: Any number between “1” and “20”
-days
Specifies how many days worth of WODs to show. By default it is set to “1”, showing only a single day’s workouts. But it can be set up to “30” to show a whole month worth of WODs. One possible implementation is to set it to “7” with no date specified. If you placed this on a page, it would always show the WODs for the past 7 days.
e.g.
Options: Any number between “1” and “20”
By default,
will show the recent workouts posts from your gym. The length of the list will be determined by your default settings. This shortcode is designed to be placed on a page where you’d like to showcase all the recent activity at your gym.Parameters:
You can use the following parameter to override your default settings.
-length
Specify how many Recent Posts to display
e.g.
Options: Any number between “1” and “30”
The leaderboard shortcode must always have a workout specified. If you don’t set a specific length parameter, the leaderboard will use your default setting.
-workout_id (*required)
Specify the workout id of the desired workout. Use the universal search at the top of the site to quickly find any workout. Then locate the workout id by looking at the URL for the workout page. (e.g. http://beyondthewhiteboard.com/workouts/13 for Fight Gone Bad)
e.g.
-length
Specify how many top places to display.
e.g.
Options: Any number between “1” and “20”
Tried to use the plugin within wordpress 4.9.1 without success.
Found in the readme.txt of the plugin that it is tested up to 4.6.1 only …
Are you using the plugin from this article specifically? We have a new plugin that you can learn about here: https://blog.beyondthewhiteboard.com/2017/05/09/new-wordpress-plugin/. Let us know otherwise.
-BTWB