Papaya YouTube Widget

• Log onto https://developers.google.com with a Google account
• Go to https://console.developers.google.com/project
• Click the blue plus sign to Create Project
• Name it whatever you want, e.g. your website’s name, and click create
• Once Google is finished creating the project, use the navigation menu to go to the API Library
• Choose YouTube Data API v3
• Double-check that you have the right project selected in the dropdown menu at the top, then click Enable
• Click Create Credentials on the new screen you are taken to.
• In the settings, choose YouTube Data API v3, Web Browser (Javascript), Public data, then click “What credentials do I need)
• Your key should appear. Copy it to the plugin settings. (If you lose it, it will still be available from your Google developers console.)
• Click Done.

… Or, take the optional security steps before you click done:
* You may want to restrict the use of your API key to only calls from your website. If so, click restrict key.
* On the page that appears, choose HTTP referrers, and enter your website’s domain, like this .your-domain.com/, under website restrictions.
* Click Save.

To get your channel ID:
* Sign in to YouTube.
* In the top right, click your profile picture.
* Select Settings from the dropdown menu.
* Select Advanced settings from the menu on the left.
* You’ll see your channel’s user and channel IDs.
* Copy the channel ID to the plugin settings.
If you have trouble finding it, refer to Google’s own documentation.

Under Appearance > Widgets, add the Papaya YouTube Widget to the sidebar/widgetized area where you want your YouTube Channel featured. If you set a Channel ID for the Widget, it will override the Channel ID set on the settings page.

Using the classic editor or the Gutenberg shortcode block, insert the shortcode [papaya_youtube_widget] into your site where you would like your YouTube channel videos to appear.

You can optionally add the following attributes to the shortcode:
* channel_id: A string that is a valid YouTube channel ID. Overrides the channel ID set in the plugin settings.
* videos: An integer between 1 and 25. The number of videos to display. Defaults to 5.
* anchor: Any alfa-numeric string. The anchor text for the link to the YouTube channel. Defaults to no link.

E.g. [papaya_youtube_widget videos=9] will insert a grid with nine videos into the post or page where you use the shortcode.

Well, there aren’t any settings for doing so, but you can make some changes with a bit of custom CSS in your theme customizer:

You can, for example, change the number of columns of videos under the main video by changing the width of the videos.

For one column, add this:
.pyw_poster {
width: 100%;
}

For three columns:
@media only screen and (min-width: 481px) {
.pyw_poster {
width: 31%;
margin-right: 3%;
}

div.pyw_poster:nth-child(3n+1) {
margin-right: 0;
}
}

For four, five or six columns, change the values in the code above according to the values below:
| columns | width | margin-right | :nthchild value |
| 4 | 23% | 2.75% | 4n+1
| 5 | 19% | 1% | 5n+1
| 6 | 15% | 2% | 6n+1

Double check that you are using a valid YouTube Channel ID. If you go to https://www.youtube.com/channel/YOUR-CHANNEL-ID, you should see the channel you want to embed. Then, log on to https://console.developers.google.com/apis/ double check that you are using a valid API key.

Also check the API key settings, to make sure there are no restrictions API key, preventing it from being used to access YouTube through your site. Refer to Google and YouTube’s own documentation of you are unsure about to find out. Make sure there are no unintentional spaces or characters before or after your Channel ID or API key in the settings.

Note that the widget settings are optional, and override the general plugin settings. So even if the plugin settings are correct, you may have a typo in the widget settings. When you are troubleshooting, remember to clear your caches (server- and browser-side) frequently, so you are not seeing old versions of your website.

If your videos show at first, but then stop showing during the day, you may be exceeding the YouTube API’s daily quota. That quota is quite generous, so this won’t be a problem for most users. However, if you have many thousands of video views daily (or if you are sharing an API key), you may have to apply for a quota extension.

Refer to Google’s own documentation for more about how the daily quota is calculated, or to apply for an extension.

In the http restrictions section in the Google API Console, make sure you have added the domain of the site as it appears under site address in settings. If you can’t get it to work at first, add all working versions of your domain, e.g. with both http and https, with and without sub domains, with and without a trailing slash.

If you would like to hire someone to help you customize this plugin to fit your site better, please contact plugin developer Sagar Gurnani

If you would like to hire someone to help you with content production, digital marketing and promotion of your site, please contact Papaya design & marketing