# Wordpress

The steps below will integrate ParOne into your Wordpress website.

# ParOne's demo site

You can view a demo version of the wordpress site here: https://wordpress.parone.com (opens new window)

This site will show you examples of the shortcodes and the different style of players.

# Installing ParOne in WordPress

Download and install our WordPress plugin from the official Wordpress.org site.

Click to download

Install the zip file from the "Install Plugin" page of your WordPress admin console.

# Configuring ParOne in WordPress

# Quickstart

The below section 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
  • Change "Default ParOne Feed" to the default Feed ID you'd like to use.
  • Change "Default Environment" if you're doing testing with ParOne engineering.
  • Click "Save Changes"

ParOne Wordpress Settings



# Configuring ParOne by auto publishing Posts


NOTE

  • This configuration is only required if you want ParOne to automatically create posts that will be your Posts section

The ParOne plugin can automatically post new videos into your WordPress Posts. Once you set the feed information above you should determine a few things:

# Considerations when Auto-Posting

  • What category, if any, should the video posts have?
  • What tags, if any, should the video posts have?

By using categories and tags, you can put the ParOne videos in the appropriate sections of your site. If you don't want to use categories or tags, just set the category to "Uncategorized" (the default) and set the tag to "none" (the default)

# What template should the video posts use?

If you have a preferred template to use for posts, you can select it here. If you don't want to use a custom template select "none" (the default)

# What type of post should the videos have?

If you want to set the post type, choose it here. The default is "post."

# Who should the author be for the posts?

If you want to set the post author, choose the username from the list. The default is no author (ID 0).

# What status should the video have?

When a video is created should it be visible, or do you want someone to review it? Set the post status to "draft" and you will have to review the video and set it to "publish" by hand. Set the post status to "publish" for the videos to automatically publish to your site.

# How often should the videos be posted?

If you choose "Daily", the videos will be posted once a day. If you choose "Hourly" they'll be posted every hour or so. "Daily" will be about 24 hours from when the auto-post functionality is enabled. "Hourly" will be about 60 minutes from when the auto-post functionality is enabled.

# How many videos should be posted at a time?

There may be more than 1 video ready to post...but your users may not want to see 3-5 videos in a row. You can use this and the post time setting above to spread videos out.

For example, if five videos are available you can choose "hourly" for the post interval and set the number of videos to post to 1. The plugin will post one video an hour until all the available videos are posted. If you choose "daily" and set the number of videos to post to 10 the plugin will post up to 10 videos every day, depending on how many videos are available at posting time. If there were only 5 videos available the plugin would post 5 videos.

Here's what the default settings look like:

NOTE

  • To turn on the auto-poster, set the "Auto-Post via RSS" setting to "Enable."

ParOne WordPress Auto-Post Settings


NOTE

  • The "last campaign ID posted" is used by the plugin to track what was posted. If it's 0 then all the available campaigns will be posted, including campaigns that have been posted before. You should not change this value unless directed to by support.

# Styling the automatic posts

When the auto-poster posts a video, the descripiton and title of the post are set, a custom short code is inserted that has custom styling. Because the post has its own title and description, the video player used by auto-post has no title or description.

You can customize the style used by the auto-poster in the "Custom RSS Video Player Styles" section in the style editor. Learn more in the Style Editor for Wordpress section.


# Setting up Dynamic pages


NOTE

Setting up dynamic pages will be used to create dynamic pages like "https://yoursite.com/parone/123" where "123" is the ID for a particular video campaign. 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.



# Shortcodes

You have access to the following shortcodes:

Use these shortcodes as needed to incorporate ParOne videos anywhere in your wordpress website.


# ParOne Video Player Single Post

The [parone_video_player /] shortcode is a single video player. 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 Single Post.

[parone_video_player /]

You can pass a campaign ID to it, like campaign="234" or generate this page dynamically. See more information about overriding defaults.

[parone_video_player campaign="234" /]



# Single Post, Looping 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" /]



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_vertical_thumbnail_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_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., 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.

[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" /]



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" /]



# Style Editor for Wordpress

Follow the video below to customize how you want ParOne to look inside of your wordpress website.




# 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, campaigns, 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
campaign The campaign ID for a specific campaign containing a single video.
env Default: prod. You can use stage during testing.
feed The feed id for your feed. This is found within the ParOne interface.

# Campaign

If you're curating content for your site, you'll often be reviewing our available content and then picking specific campaigns. You can pass specific campaign IDs to the video player.

Here's a quick example:

[parone_video_player campaign="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" /]

# Environment

We provide two environments depending on the stage of development you're working in. You can configure which one your site uses. the choices are prod and stage.

Here's a quick example:

[parone_video_player env="stage" /]
Last Updated: 10/10/2021, 3:19:20 PM