Automatically generate WordPress posts or pages for your videos
Auto Post allows TubePress to automatically generate WordPress posts or pages for each video in a TubePress gallery. This powerful feature, introduced in TubePress 5.1.0, enables two main benefits for WordPress users:
Dramatically improved search engine optimization (SEO)
Each video in a TubePress gallery will be linked to a post or page on your site. With properly-configured permalinks, this can lead to a significant boost in search ranking for your site's subject area.
In-house discussion threads
Since each video now occupies a post or page on your site, you can completely control the comments and discussion for your videos. You can utilize WordPress's built-in comment system or a popular third-party system such as Disqus.
Auto Post is essentially like having a personalized youtube.com (or vimeo.com or dailymotion.com, or a combination of these) hosted entirely within your website.
For every video in a TubePress gallery with Auto Post enabled, TubePress will create and link a WordPress post (or page) to house the video player, metadata, and comments.
These are standard WordPress posts/pages that you can manage as usual. The post/page titles are based on the video title by default, but this is fully configurable.
The content of each post/page is fully configurable and can be customized to your liking.
**Auto Post has the capability to quietly generate an enormous number of posts or pages on your site. Please ensure that you read these instructions carefully and understand the ramifications of enabling this feature.**
- Navigate to the TubePress options page at
WP Admin > Settings > TubePress.
- Click the "WordPress" tab and scroll down to the "Auto Post" area. Adjust your settings, and when you're ready, tick the box for "Enable Auto Post" to activate the feature. Each setting is described in detail below.
- Visit a page on your site with a TubePress gallery. If you have configured
Auto Post > Statusto be anything other than
Publish, you'll need to manually publish the posts/pages (e.g. from
WP Admin > Posts) before any videos show up in your gallery.
In this section we describe each Auto Post setting in detail.
Enable Auto Post
Enables or disables the Auto Post feature site-wide.
The type of the posts that will be created. Typically this is posts or pages, but it also includes any custom types that you may have in your installation. Only public types are allowable.
The initial status of the posts that will be created. TubePress will only display videos when their corresponding post status is public. Selecting a non-public status here (e.g.
Pending) will allow you to review posts before they are published.
The WordPress user that will be listed as the author of the new posts.
The template that will be used to display the new pages. This setting only applies when "Type" is set to
Page, as WordPress doesn't allow for posts to utilize custom templates (at least not by default).
Any WordPress tags that should be assigned to each new post.
Any WordPress categories that should be assigned to each new post.
TubePress will need to assign a publish date for each new post. You may choose to use either the video's publication date, or the date that TubePress creates the post.
Enables or disables WordPress comments for the new posts.
Whether or not the post can accept pings.
You may password-protect each new post. Leave this field empty to disable password protection.
This feature is for advanced users only. A Twig fragment, which must compile to a simple JSON object with scalar keys and values, that defines post metadata to be inserted. See the Variables section below for the variables available to you.
Below is a list of template variables that may be used in Auto Post.
|An object, representing the video, with the attributes found here. You may use a dot (|
|A WP_User instance representing the author of the post.|
|An array, which may be empty, of WP_Term instances representing the categories assigned to the post.|
|Post metadata that will be inserted along with the post. This includes information internal to TubePress, along with any metadata that you have defined in the setting for "Metadata template". Of course, this variable is not available to the "Metadata template" as that would result in circular logic.|
|The password used to protect the post. This may be empty if no password was set.|
|An object representing the status assigned to the post. The |
|An array, which may be empty, of WP_Term instances representing the tags assigned to the post.|
|The WordPress template that will be used to display this post. This will either be |
|A DateTime instance representing the post publication date and time.|
|The post title, as calculated by the setting for "Title template". This variable is only available to the "Content template" setting.|
|An object representing the type assigned to the post. The |
Yes, you can enable/disable Auto Post on a per-gallery basis using shortcodes. Use
[tubepress wpAutoPostEnable="true"] to enable and
[tubepress wpAutoPostEnable="false"] to disable. (For more information on shortcodes, see this page.)
If your post/page status is anything other than "Publish", your gallery will not display. Check for any "Pending" or similarly non-public posts/pages from
WP Admin > Posts or
WP Admin > Pages and publish or delete them as appropriate. If you delete posts/pages, you will also need to fully delete them by emptying the trash (e.g.
WP Admin > Posts > Trash).
With Auto Post, the embedded video player for each video in a gallery is housed on a linked post/page rather than where your Auto Post-enabled gallery appears. Essentially, an Auto Post gallery is a gallery of video thumbnails. Clicking one of the thumbnails will direct you to the post/ page where that video can be played, commented on, etc.