“Youtube Videos To Wordpress Posts” Documentation by “KAYO” v1.0

Created: 14/10/2015
By: KAYO
Email: [email protected]

Thank you for purchasing our plugin. If you have any questions that are beyond the scope of the documentation, please feel free to email us via the user page contact form here.


Table of Contents


Quick Start Guide - top

To easily get started with the plugin, you can watch the video below and test the plugin on the demo website.



After setting your Google developer key you can click on the new import link to set your import options. For this demo I'm going to import the WPBeginner user, so go ahead and select user on the Feed Type and then fill the user id. without setting any other options, you can click on the save and import button and wait a moment to be redirected to the results page.

On the result page, you can select the videos that you want to import and click on the Import Selected button. If you visit the posts page on the dashboard, you can see that the videos are imported to your Wordpress installation successfuly. The documentation will guide you through the list of available options.

Setting Your Google Developer Key - top

Before you start using the plugin, you must get a Google API key. Navigate to the Youtube API Settings menu, follow the instructions to get your API key and paste it on the Developer Key input.

Steps

After signing to Google account, navigate to the Developer Console and click on the Create Project button.

Create Project

Create Project

Give your project a name and click create. Now you can select your project from the list at the top of the window.

Choose Project

Choose Project

The left menu contains an APIs & auth menu where you can activate Youtube API if it’s not activated by default.

Activate Youtube API

Activate Youtube API

Select credentials and create a new API key.

Create API Key

Create API Key

Plugin Dashboard - top

The plugin dashboard shows the list of imports with the pagination and filter options. You can see more details about the import by clicking the Load feed link.

Imports list

Imports list

To minimize the number of API requests, we implemented a caching system for results and it’s cleared whenever you change the import options. You can clear the cache by clicking on the Clear Cache link on list items. When you remove an import, the list of posts you imported are also going to be removed from Wordpress. Make sure that you don’t remove any existing data.

New Import - top

You can create new imports from the New Import link. You have the option to import channels videos, playlists, user videos, search using a query, single video. Before exploring each import type, lets talk more about option tabs.

New Import

Feed Options - top

The feed options tab is where you’re going to specify your feed details. Most fields are self explanatory, but some are Not :)
Bulk import allows you to import all the results of this import directly without seeing the list of videos. This is useful when importing a playlist or channel.
Advanced video filter allows you to filter down videos using video definition, duration, category, etc. This option is only available for channel and search query imports.

Feed Options Tab

General Options - top

The general options tabs specify how videos are integrated into Wordpress.

General Options

Embed Options - top

The embed options tab specify how videos are inserted into Wordpress. You can create the necessary HTML markup and inject variables like video_key, video_url, video_description, video_title, etc. You can also use the [yvtwp_video] shortcode to simply add the Youtube video iframe. The bottom section is used to map those variables to custom fields by selecting an existing value or taping your own value. This option lets you easily integrate imported videos into your theme.

Feed Options Tab

Title & Description Options - top

The title and description options allow you to perform transformation to the title and the description by removing, adding and replacing keywords from the text.

Title Options Tab

Description Options Tab

Date Options - top

The date options tab allows you to specify publish date for the import. You may use the Youtube video publish date, insertion time or specify your own custom date. The custom publish date option may be used to generate random values to make dates seem more realistic, the min and max values are used to calculate an in-between value.

Date Options Tab

Default Import Settings - top

The Default Import Settings page will save you the time of typing the same details every time you want to perform a new import.

Default Import Settings

General Settings - top

The general settings tab allows you to adapt the plugin to your needs. Lets see each one apart.

General Settings

Scheduling Settings - top

This tab lets you specify how your scheduling imports work. You need to enable it using the first option for changes to take effect. You may specify the cron job type to use (Wordpress or Native), and how often the cron job recur. When you create a new import and set the Import type to Scheduled Import, those settings will take effect, you can also disable scheduled import for a single import using the ON/OFF switch at the bottom.

Scheduling Settings

Import/Export Settings - top

To create portable import settings like specific configuration for themes, we made it easier to export your installation settings, you configure your default settings and then export it and share it with others.

Import/Export settings

Importing Feed - top

After selecting the feed type and filling tabs accordingly, you can click Save and Import feed to start the import. This will show the list of found videos (except for single video import) with pagination if necessary. If you chose to do a bulk import, you’ll be redirected the screen showing the import progress.

If a video already exists, it will have a label next to the video title. You can also customize which video details you want to show on screen and how many videos to use for the pagination.

Import result

The below video shows a demo on the basic plugin usage.

Log System - top

The Log System page is a nice way to track your plugin status, you can track system errors, Youtube API errors, Scheduled Imports, etc. The results are paginated and can be filtered to help you track the logs.

logging

Key Features - top

Screenshots - top

Import result

Bulk Import

Imports

Feed Options Tab

Schedule Options

Youtube API Settings