Wordpress
The steps below will integrate ParOne into your Wordpress website.
Preflight
Prior to integrating ParOne, make sure the following as been completed:
- Your organization has created a feed.
ParOne’s demo site
You can view a demo version of the wordpress site here. This site will show you examples of the different configuration of players.
Installing ParOne in WordPress
Download and install our WordPress plugin from the official Wordpress.org site.
Install the zip file from the “Install Plugin” page of your WordPress admin console.
Quickstart
The section below will get you started with using Shortcodes right away.
Add your default feed name to your WordPress settings.
- Go to WordPress admin
- Navigate to ParOne Feeds -> Video Library
- Enter your Feed Key from your ParOne Account Manager
- Click “Get Feeds”
Shortcodes
You have access to the following shortcodes:
- Installing ParOne in WordPress
- Quickstart
- Shortcodes
- Styling
- Setting up Dynamic Pages
- Overriding Defaults
Use these shortcodes as needed to incorporate ParOne videos anywhere in your wordpress website.
ParOne Video Block
The [parone_video_player /] shortcode is a single video block. This is best used on a single page or post entry where you’d like to add an inline video player inside.
For more information on this player type, see Video Block.
[parone_video_player /]You can pass a content-key to it, like content-key="234" or generate this page dynamically.
[parone_video_player content-key="234" /]ParOne Video Block Playlist
The [parone_video_block_playlist /] shortcode is a single video player with a looping playlist. This is best used on a single page or post entry where you’d like to add an inline video player inside that autoplays content and you don’t want the user to be select new videos
For more information on this player type, see Single Post, Looping Playlist.
[parone_video_block_playlist /]You can pass a seperate feed ID to it, like feed="test". This is useful is you want to use multiple feed on different places in your wordpress website. See more information about overriding defaults.
[parone_video_block_playlist feed="test" /]ParOne Thumbnail Carousel
The [parone_thumbnail_carousel /] shortcode is used on blog and directory pages. This method is also best when you have dynamically inserted ads on your site and each video would equate to another page view.
For more information on this player type, see Thumbnail Carousel.
[parone_thumbnail_carousel /]You can also make this vertical.
[parone_thumbnail_carousel vertical="true"/]You can pass a seperate feed ID to it, like feed="test". This is useful is you want to use multiple feed on different places in your wordpress website. See more information about overriding defaults.
[parone_thumbnail_carousel feed="test" /]ParOne Video Playlist
The [parone_video_playlist /] shortcode gets a list of videos for the default feed, established in settings. This is best used for a single page (e.g., https://yoursite.com/videos/). In this page, you will have the entire playlist, plus the player for your user to consume videos and never leave the page.
For more information on this player type, see Playlist.
[parone_video_playlist /]You can pass a seperate feed ID to it, like feed="test". This is useful is you want to use multiple feed on different places in your wordpress website. See more information about overriding defaults.
[parone_video_playlist feed="test" /]ParOne Playlist with Carousel
The [parone_playlist_carousel /] shortcode gets a list of videos for the default feed, established in settings. This is best used for a single page (e.g., http://yoursite.com/videos/). In this page, you will have the entire playlist, plus the player for your user to consume videos and never leave the page.
For more information on this player type, see Playlist with Carousel.
[parone_playlist_carousel /]You can pass a seperate feed ID to it, like feed="test". This is useful is you want to use multiple feed on different places in your wordpress website. See more information about overriding defaults.
[parone_playlist_carousel feed="test" /]Styling
Custom stylesheets can be added in Wordpress by going to ParOne Videos -> Custom Stylesheets. You’ll need to host your CSS on your server and copy / paste the URL to the .css file in the corresponding video player. Using a shortcode will automatically render the stylesheet.
Setting up Dynamic Pages
This configuration is only required if you want to use Thumbnail Carousels within your site.
Setting up dynamic pages will be used to create pages like “https://yoursite.com/parone/?parone-content-key” where “?parone-content-key” is the content-key for a particular video. This is used for thumbnail carousels where a user will click a thumbnail and then load a seperate page to load the video itself. This is useful for those wordpress sites that integrate advertisements and want additional click throughs and pageviews.
Create a page with the permalink / slug “parone” in your site, and add the shortcode [parone_video_player /] shortcode somewhere on the page. Feel free to include any other content on the page you would like including advertisements, widgets, etc.
Overriding Defaults
There is no restriction to the default feed you choose from the settings panel. These are just convenient default settings. You can override those settings to target specific feeds, content-keys, or environments.
For example, let’s say your default feed is “feed-a” and you want to use “feed-b”, well then you would setup your shortcode like this:
[parone_video_player feed="feed-b" /]There’s a few parameters you can set in your shortcodes.
| Name | Description |
|---|---|
| content-key | The content-key for a specific video. |
| env | Default: prod. |
| feed | The feed id for your feed. This is found within the ParOne interface. |
Content-Keys
If you’re curating content for your site, you’ll often be reviewing our available content and then picking specific content-keys. You can pass specific content-keys to the video player.
Here’s a quick example:
[parone_video_player content-key="2062" /]Feed
ParOne accounts can potentially have many feeds, so you may need to add blocks for different feeds on different pages.
Here’s a quick example:
[parone_video_player feed="golf-max" /]