Video import debugging

To debug your automatic imports and get a detailed log of each import running, please download and install the debug utility plugin.

How to install

To install the plugin in your WordPress website, go to WP Admin Plugins page and from the submenu choose Add new. Next, click Upload plugin next to the page title and using the upload form, choose the debug utility plugin archive.

WordPress install plugin manually

Once successfully uploaded, WordPress will install the plugin and after finishing it will ask if you want to activate the plugin. Once the plugin is successfully activated you will notice a new entry in main plugin menu named “Debug”. This page will display the latest log entries that can be used to check if imports are working and that everything works OK.

Video image import

When importing a video as a WordPress post, you also have the possibility to import its image as post featured image. This is handy for a complete import that will display a post having all information.

For additional information about how to enable image importing at the same time with the video please see Image import options.

Bulk importing images

The plugin also offers the possibility to bulk import video images and set them as post featured image for any custom post type video or post created by the plugin.

WP YouTube plugin bulk import images

This is done from WordPress bulk actions by selecting the “Import thumbnails” action. The plugin will do its work in the background and will announce you when everything is done. This action should be used just like any other default WordPress bulk action.

Importing/updating a video post featured image

YouTube video image can be imported as featured image for individual posts created by the plugin when viewing the post in edit screen.

WP YouTube plugin post import featured image

In “Featured image” meta panel you will notice a new button “Import YouTube thumbnail“. When clicked, this will trigger the featured image import process that will automatically set the current YouTube video image as post featured image.

Automatic video import

Automatic video imports are imports that you can create from YouTube playlists, channels or user uploads. Automatic imports can’t be created from searches.
These imports run in the background of your website and are triggered at different time intervals that you can set up from plugin settings.

Important considerations

Before creating automatic importing playlists, please take under consideration the following limitations:

  1. The first thing to understand is that imports are triggered by your website visitors. When your website receives a visit, if it is time to run the import process, the plugin will automatically trigger it. Simply put, if you set imports to run every 5 minutes but your website doesn’t receive visits that often, imports will be delayed.
  2. The plugin imports one playlist at a time. If you create a large number of automatic imports, the update delay for any given playlist will take longer.
  3. Avoid overloading your server by not setting the automatic import to grab too many videos at once (see plugin settings). Around 15-20 videos should be enough unless your server can handle more.

Creating an automatic import

To create a new automatic import, go to plugin page Automatic import and click the Add new button next to the page title.

WP YouTube plugin create new automatic import

The automatic import edit page will open and you can begin creating your new automatic playlist import.

WP YouTube plugin automatic import setup

The available settings allow you to customize any automatic YouTube video import to respond to your needs.

Playlist name

The playlist name is used exclusively for internal purposes. Use a name that has relevance to you so you can quickly find the playlist into the general list or automatic imports.

Feed type

The feed type defines the type of resource that you want to query and import. You can choose between YouTube playlists, channels or user uploads. This option works in conjunction with Playlist ID.

Playlist ID

The ID of the playlist, channel or YouTube user according to the selection made under Feed type. To make sure you got the settings right, always make sure to check the playlist using the settings button next to this field.

Import as user

Optionally, choose to import as a different user, other than the one currently logged in. Please note that if your website doesn’t have multiple users that have at least post creation capability, this option won’t be displayed since it’s unnecessary.

*Import if published after

In case you don’t want to import the entire feed, choose a starting date in order to instruct the plugin to import only videos that were created after the selected date. Leave empty to import the entire feed.

* Will not apply to YouTube playlist imports, only user uploads and channels.

Add to import queue

When checked, the playlist is added to the import queue and will import as soon as its turn comes into the queue.

When finished, import only new videos

When checked, after the plugin finishes processing all videos from a feed, when a new import is scheduled, it will only check for new videos without reiterating the entire feed.
While for channel and user feeds this setting works by default, for playlists you must set them on YouTube to be ordered by date added to playlist, otherwise you might experience some weird behavior.

Import in category

This option allows you to import the videos from a feed either into an existing category or you can instruct the plugin to automatically create categories from the categories retrieved from YouTube.

Automatic imports management

All automatic YouTube video imports created with the plugin allow you to perform a series of actions on them. For example, you can pause them from importing or reset them in case you need to.

WP YouTube plugin automatic import playlist options

Just like regular posts, when you hover over an automatic import, a set of extra actions will be displayed. Pausing a playlist will remove it from the import queue (you can resume the import at a later time) while resetting a playlist will reset all its counters and force the importer to reiterate the feed starting with the first videos.

Manual video bulk import

To manually bulk import videos, from plugin menu go to Import videos and fill your import search criteria.

Performing a search

Searching for videos is done by providing several search options.

Feed type

Allows you to choose between 4 types of feeds:

  1. Search query: performs a search on YouTube based on your search query and shows all the results returned;
  2. Playlist: loads a YouTube playlist based on the playlist ID provided by you;
  3. User: loads all uploads made by a certain user based on the username;
  4. Channel uploads: loads all videos from a given channel ID.

Video duration

Applies only for search queries and retrieves only videos that have more than the given length. You can search for short videos (under 4 minutes), medium length videos (between 4 and 20 minutes) and long videos (over 20 minutes in length).

Search query

This is the search you want to retrieve videos by. Depending on the type of feed chosen, this setting must be playlist ID, user ID or channel ID for playlists or user feeds.

Order by

This is the order that the retrieved videos will be displayed (ie. date of publishing, views, search relevance, rating etc.).

Once all search preferences are filled in, hit Load Feed button. A paginated results page will be displayed containing all the results returned by your query. To change the number of results displayed per page you can modify the option available under video import settins.

The search results page

Once a search is successfully made you will see the search results page that will allow you to import YouTube videos as WordPress posts.

WP YouTube plugin bulk import search results

To import a video you must first make sure you check the option “Import this video” available for each video. Optionally, if you want to import all videos displayed on one search result page just check “Select All” option that is available above the search results.

Editing a video before importing

Into the search results page, for each video displayed you can customize the title and description before actually importing the video. This is done by directly editing the title and description fields that are present for each result.

WP YouTube plugin bulk import video edit

Changing the search

To modify the search and look for a different result set, simply click “New search” button next to the title. This will open the search form and will allow you to either refine your search or look for something totally different.

WP YouTube plugin bulk import search edit

Importing the selected videos

The final step and main purpose of this page is to allow you to import your YouTube videos into WordPress posts. This is done using the available import form that will allow you to optionally specify the WordPress category in which you want to import the videos and also, in case of multiple users with at least the capability to create posts, allows you to choose the user under which the posts will be created.

WP YouTube plugin bulk import import options

Please note that in case you don’t have multiple users having at least post creation capability, the option to choose the user under which to create the posts won’t be displayed and all posts will be created on behalf of the currently logged in (admin) user.

Single video import

To import a single YouTube video and create a WordPress video post, go to plugin menu Videos, page Add New.

WP YouTube plugin single video import

All you need to do is enter a valid YouTube video ID and hit Search video. If video is found, you will be taken to custom post edit page and, depending on your global settings for importing titles and descriptions, will have post title and post content already filled with the title and description retrieved from YouTube.

Categories, if option for importing categories from YouTube is checked, will also be assigned to the new post automatically.

Video embed options

These options control how the plugin embeds the videos into the post content. Please note that these settings apply only if you embed videos using the plugin functionality. In case you made your WordPress theme compatible with the plugin these options won’t apply.

Please note that the embed options can also be modified for each individual video post by editing the post in WP admin.

The options can be found in WP admin plugin menu Videos, page Settings, tab Embed options.

WP YouTube plugin video embed options

Player size

Allows you to choose the default size of the player (can be modified for each individual video post). You can set up the aspect ratio and width, the height is automatically calculated by the plugin.

Show video in custom post

Choose the default position where the video is displayed into the video post. Choices are below the post content or above it.

Volume

Set the default video volume for all videos imported into WordPress.

Autoplay

Check this option if you want to autoplay the videos when a visitor sees your page (not available for mobile visitors).

Show player controls

Choose whether the player controls are visible or you just want to display the player without any controls.

Allow fullscreen

Allow the video to go full screen.

Autohide controls

Choose between different ways of displaying the controls into the player: always show them no matter what the video status is, hide controls when video is playing or fade out progress bar when playing.

Player theme

Choose from the 2 available themes: light or dark.

Player color

Choose between the red player ad the white one.

No YouTube logo on controls bar

When this option is checked, YouTube logo won’t be displayed on the controls bar but will be visible over the video when it is paused.

Annotations

Show or hide all video annotations set by its owner.

Show related videos

Choose to show related videos into the player once the video has reached the end.

Show video title by default

Show video title into the video player.

Disable keyboard player controls

Choose to disable all keyboard controls for the video player.

Video import options

These options control how bulk import and automatic import will work when importing complex feeds from YouTube.

These settings can be found under plugin admin menu Videos, page Settings, tab Import options.

WP YouTube plugin import options

Import status

Using this option you can set the post status that the posts created by importing videos will have by default.
For example, if you would like to review the posts first, you might want to set this to Draft or Pending, depending on your preference. Or if you want the video posts to be visible once created, just set this option to Published.

Automatic import

This is how you control how often an automatic import should be triggered and at what interval. The maximum number of videos that can be imported at once is 50 but you shouldn’t set it to this value unless you’re sure that your server can handle the load.

To better understand this, when importing 50 videos the plugin is programatically creating 50 posts and if the option to import the featured image is also set, at the same time it will also create 50 entries into your WordPress media gallery. Due to the complexity of the process, this can end up with errors so you should never exceed 20 videos at a time unless your server can handle it.

Enable conditional automatic imports

When this option is enabled, automatic imports will be performed only if a certain URL receives a visit. Even if the time to perform an import is reached, no automatic import will be made unless it’s on the right URL. The URL (that is specific for your website only) will be displayed when this option is enabled.

This feature can be used if your website doesn’t receive enough visits that allow the plugin to make automatic imports with regularity or you own a website where the incidence of triggering concurrent imports due to high traffic is highly probable.

The way this feature can be used is by either setting up a cron job on your server that will access the link with regularity or use a different mechanism of your choice, like a website monitoring system that will ping your website at a given time interval.

Legacy automatic import

Starting with plugin version 1.2, automatic import is triggered by making a remote call to your website that triggers the import. This decreases page loading time and improves the import process.

While this works in most cases, some systems may not allow this functionality so if you notice that automatic imports aren’t importing, enabling this option will solve the problem.

Remove playlist from queue on YouTube error

When you create an automatic import you basically tell the plugin: import YouTube playlist having ID X.
If at a later time this playlist is removed from YouTube for any reason, in order to prevent the plugin from making useless calls to YouTube that query a nonexistent playlist make sure you check this option.
When this option is enabled, the first time the plugin queries YouTube and it returns an error the plugin will automatically pause the imports for that playlist. In turn, this allows you to notice that something is wrong and signals that you should start investigating.

Manual import results per page

With this option you can control how many videos are displayed per page when making manual bulk imports.

Image import options

The image import options determine how YouTube videos images are imported into WordPress. These options can be found under plugin admin menu Videos, page Setting, tab Image options.

WP YouTube plugin video image options

Import images

When checked, this option tells the plugin to also import the video image into WordPress media gallery and set it as featured image for the post created based on the video details retrieved from YouTube. In this case, the image will be imported at the moment when the post is created.

Import featured image on request

When image importing is allowed (Import images option is checked), by enabling this option you can delay the image import option until the image is actually needed. In this case, the featured image won’t be imported at the time that the post is created but a later time, when WordPress will need to display it somewhere in your website. This feature is useful if you want to remove some load from the import process since image processing is usually a resource consuming process.

Image size

This option allows you to set the maximum image size that you will import from YouTube for your imported videos. Please note that WordPress will still create all registered intermediary image sizes, no matter what maximum image size you choose here.

The extra option present for this option (retrieve maximum resolution image), when checked, will try to determine if a large version of the image is present and if it is, it will override the main option and import the maximum resolution image. Please note that not all videos have such image size.

Content import options

Content import options allows you to choose which information will be imported by the plugin when creating a new video post. These options apply to all imports made by the plugin, be it single video import, manual bulk or automatic imports.

These options can be found under plugin menu Videos, page Settings, tab Content options.

WP YouTube plugin content options

Import categories

When this option is checked, for a given video, all categories associated with it on YouTube and returned by the API will be automatically created (if not existing) as WordPress categories and assigned to the newly created post.

Import tags

When option to import tags is checked, the plugin will import the number of tags that you enter under option Maximum number of tags. If importing for WordPress theme, please make sure to specify a tag taxonomy.

Import date

If this option is selected, instead of setting the post publishing date to the actual date the post was created in WordPress the plugin will set the date to the publishing date retrieved from YouTube.

Import titles

When checked, the title retrieved from YouTube will be set as post title when creating a new video post based on a video retrieved from YouTube.

Import description as

This option allows you to choose how to use the video description retrieved from YouTube when creating a new video post. Available options are to use the description as post content, post excerpt, set the description for both or not to import the description at all.

Remove text from description found after

This option allows you to automatically truncate video descriptions retrieved from YouTube if a certain sequence of text is found into the description. This is useful if you import videos from your own channel and you don’t want the entire description imported by the plugin.

Prevent auto embed on video content

The default WordPress functionality when you paste a YouTube link into a WordPress post is to automatically embed the video from that link into the post content. Videos retrieved from YouTube might have such links into their descriptions and when that is imported as post description into WordPress, the links will be embedded automatically.
To prevent this from happening, make sure this option is checked.

Make URLs in video content clickable

When retrieving videos from YouTube, their descriptions might contain links to various websites of interest that are related to the video. By default, those links will be displayed as regular text that your users can’t follow by clicking on it. To change this, check this option in order to automatically make the links clickable.

Video post type

Plugin post type options allows you to choose the post type under which you want to import YouTube videos as WordPress posts.

These options can be found under plugin menu Videos, page Settings, tab Post options.

The options are structured into 3 sections: General settings, Video post type options and Video post type rewrite.

WP YouTube plugin post options menu

General settings

By default, the plugin imports YouTube videos as plugin post type “video” with category taxonomy “videos“. This is very useful if you want to keep videos separated from other post types and it’s easier to customize WordPress themes with custom post type templates.

Import as regular post type post

If you want to change the default behavior and import videos as regular post type post, you can simply check option “Import as regular post type (aka post)“. This will force the plugin to import all your YouTube videos as regular posts and also do all the embedding into your posts.

Embed videos in archive pages

By default, the plugin will only embed videos on single post pages. To embed videos in archive pages, make sure you enable this option. Also please note that your website might get slowed down due to embedding a large number of videos at once.

Include microdata on video pages

From Wikipedia:

Microdata is a WHATWG HTML specification used to nest metadata within existing content on web pages. Search engines, web crawlers, and browsers can extract and process Microdata from a web page and use it to provide a richer browsing experience for users.

If this option is enabled, the plugin will display the following microdata information into video pages: video duration, title, description, thumbnail and upload date.

Check video statuses after import

When this option is checked the plugin will perform a daily verification for each video post that receives a visit and will query YouTube to check if the video is still public and wasn’t removed, due to various reasons, from YouTube. In case a video was removed, the plugin will set the post status to pending review, making the post inaccessible to your website visitors.

Please note that this verification is triggered by your website visitors, if you don’t receive enough visits on your website, this functionality won’t be triggered.

Video post type options

These options apply only for custom post type video implemented by the plugin. If you choose to import videos as regular post type, none of these settings will apply to your videos.

Video post type is public

When importing videos as custom post type video, the post type can be registered as private. This means that post type video won’t be visible in your website front-end but videos can be used to create playlists or embed them using the plugin shortcode.

Include video post type on homepage

If your WordPress reading settings are to display a list of your newest posts in your front-page, by checking this option you can mix your regular posts with video post type in your front-page.

Include video post type in main RSS feed

Similar to the above, when checked, custom post type video will be present into your main RSS feed, mixing posts with video post type.

Video post type rewrite

This section allows you to modify the slug for custom post type video and the category taxonomy videos.

Post slug

This option allows you to change the custom post type video slug from video to anything you want. Please note that this value mustn’t contain any spaces or special characters and must be unique on your website.

Taxonomy slug

This option allows you to change the taxonomy slug videos from videos to any custom value you need. Similar as above, the value mustn’t contain any spaces or special characters and must be unique on your website.