YouTube Showcase is a powerful but simple-to-use YouTube video gallery plugin with responsive frontend.
The following is the definition(s) of the concept(s) covered in the context of YouTube Showcase app:
YouTube video which may be displayed as single video, a collection of videos based on a video channel , custom playlist, or videos based on user defined search terms.
YouTube Showcase provides access to content based on a user's role in your organization. A role defines a set of tasks a user is allowed to perform and is assigned to a user when he or she registers into the system. Please check the Roles and Responsibilities section of this document to see the available access roles and the functionality they have access to.
Using YouTube Showcase, you can create, modify, delete, and search video records, associated taxonomies, or relationships.
To create video records in the admin area:
Videos can be modified by clicking on the "Edit" link under the video title in the video list page in the admin area. Make any necessary changes and then click Publish.
In YouTube Showcase, users are only allowed to search videos they have access to. Users who have access to videos can search using the filter system in the video admin area. You can use drag-and-drop admin interface for sorting, creating/saving complex filters, and ordering columns in the entity list pages.
To schedule Videos for publication on a future time or date in the admin area:
To create a password protected video in the admin area:
Only an Administrator and users with "publish" right can change the password set for your video or modify visibility setting by clicking the "Visibility: Edit" link again.
When video content is password protected, video title displays the text "Protected: " before the video Title and the content prints a password form with this text: "This content is password protected. To view it please enter your password below:".
If multiple videos have the same password, one will only have to enter the required password once. Only one password is tracked at a time so if you visit two different videos with two different password, you must re-enter the video password to access content. WordPress saves passwords for maximum 10 days. After this period expires, one must reenter the password again to view the protected content.
Videos can be privately published to remove them from video lists and feeds.
To create a private video in the admin area:
Only an Administrator and users with "publish" right for the video can change visibility setting by clicking the "Visibility: Edit" link again.
Only users with "publish videos", "edit private videos", "read private videos", and "delete private videos" authorization permission levels can create and see private videos. Users who have the same access level with the author but have a relationship-limited access of a private video can not view the content even if they have access rights to the content. User who have access to the content but not limited by a relationship can still see and modify private videos.
Check Roles and Responsibilities section of this document to see which user roles can privately publish videos.
To preview video content press the "Preview" button - a button directly above the “publish” button - in the publish box before officially publishing or sending for review.
To create a draft video in the admin area:
Once the video is published the user who created the video is assigned as the video author. Video authors can view and edit the video. One can change the video author from the author box. The author box drop down is limited to the users who have video "publish" right.
Video Comments allow having a discussion related to the video. Video Comments are automatically enabled when the video is created.
When you enable Video Comments on a record, a comment form is displayed under "Video Comments" section. Using the comment form here users can submit their comments.
Once a Video Comment is submitted, approve, modify, reply or delete actions can be performed either in the YouTube Showcase dashboard or in the video edit page. Once Video Comment is approved, the comment appears under "Video Comments" section of the video page right above the comment form.
One can enable or disable Video Comments in the admin area in two ways.
You can create connections between Videos and Videos by clicking on "Create Connection" link in the "Related Videos" box and then clicking on "Plus" sign adjacent to the record title you would like to connect. Optionally, you can create new record. If you create a new one, the record is created as a draft. You must publish all connected draft records to make the connections valid.
After the connection created, you can update or publish your video. You can create as many connections as you need.
Category can be set by typing the desired option in the empty text field and clicking "Add" button in "Categories" box and updating/saving the video. Setting a value for Category is optional. Category is also organized hierarchically. Categories can have multiple descendants and a single parent so that you may set up a hierarchy within the Category structure
YouTube Showcase comes with a preset Categories defined in detail in Glossary section of this document. Administrators can always add/remove/modify the list based on your organizational needs. Some widgets created upon installation are based on predefined Categories.
Tag can be set by typing the desired option in the empty text field and clicking "Add" button in "Tags" box and updating/saving the video. Setting a value for Tag is optional. Tag is also not organized hierarchically meaning there's no relationship from one Tag value to another.
Tags do not have preset values.
Displaying Video archives can be done by creating a link in the Appearance Menus Screen in the admin area.
Alternatively, if you'd like to display a specific Video, you can select the link from Video metabox and add it to your menu. If you don't see Video metabox, check the Screen Options to ensure it is set to display.
To create a custom link for Video archives:
In YouTube Showcase, Videos are locked during editing, preventing other users from accessing and modifying the Video.
If a user clicks to edit one of the Video records that's currently locked they are presented with three options in a pop-up dialog:
The user that has been locked out receives the following dialog, and is no longer able to edit the Video. It can take up to 15 seconds for the current Video editor to be notified that another user has taken over.
Widgets provide a simple and easy-to-use way of displaying content and features on your sidebars or dashboard.
Sidebar widgets can be added, removed, and rearranged on the WordPress Administration Appearance > Widgets panel. Dashboard widgets can be enabled or disabled using Screen Options tab in your app dashboard page. All widgets have drag-and-drop functionality.
The following sections list the YouTube Showcase widgets:
Featured Videos is an entity sidebar widget. It shows oldest 5 published video records without any page navigation links.
Recent Videos is an entity sidebar widget. It shows latest 5 published video records without any page navigation links.
Standard views display a single type of content in a custom format and can be used in place of archive views. Administrators can display standard views using their shortcodes by choosing the name of the view you want to display from the WPAS component list after clicking on the WPAS toolbar button on any page.
The following sections list the YouTube Showcase standard views available:
"Video CoverFlow" is a standard view which displays -1 Video records per page with a post status of publish in descending order by date. Page navigation is disabled. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video CoverFlow". You can visit this page to access the view. To display it in another page or post, use [std_coverflow] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Grid Gallery" is a standard view which displays 16 Video records per page with a post status of publish in ascending order by meta_value_num. Page navigation is enabled. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Grid Gallery". You can visit this page to access the view. To display it in another page or post, use [video_grid] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Grid Nogutter Gallery" is a standard view which displays 16 Video records per page with a post status of publish in descending order by date. Page navigation is enabled. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Grid Nogutter Gallery". You can visit this page to access the view. To display it in another page or post, use [video_grid_nogutter] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Slider" is a standard view which displays 10 Video records per page with a post status of publish in ascending order by menu_order. Page navigation is disabled. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Slider". You can visit this page to access the view. To display it in another page or post, use [video_slidegal] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Wall Gallery" is a standard view which displays 16 Video records per page with a post status of publish in ascending order by menu_order. Page navigation is enabled. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Wall Gallery". You can visit this page to access the view. To display it in another page or post, use [video_wall] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
Integration views combine interrelated views of your content in one page to provide a summary or to highlight essential information.
The following sections list the YouTube Showcase integration views:
"Video Gallery" is a combo report. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Gallery". You can visit this page to access the view. To display it in another page or post, use [video_gallery] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Grid Gallery" is a combo report. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Grid Gallery". You can visit this page to access the view. To display it in another page or post, use [video_grid_expand] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Horizontal Slider Gallery" is a combo report. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Horizontal Slider Gallery". You can visit this page to access the view. To display it in another page or post, use [video_hslider_gallery] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
"Video Slider Gallery" is a combo report. If you choose to install setup pages during plugin activation, a WordPress page is created with a title of "Video Slider Gallery". You can visit this page to access the view. To display it in another page or post, use [video_slider_gallery] shortcode or select the view name from the WPAS component list after clicking on the WPAS toolbar button.
The following table shows the capabilities and the access roles available in YouTube Showcase app. "Red" color means the users who belong to the corresponding role do not have the capability. "Green" color means the users who belong to the corresponding role have the capability.
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| Edit Videos | ||||||
| Delete Videos | ||||||
| Edit Others Videos | ||||||
| Publish Videos | ||||||
| Read Private Videos | ||||||
| Delete Private Videos | ||||||
| Delete Published Videos | ||||||
| Delete Others Videos | ||||||
| Edit Private Videos | ||||||
| Edit Published Videos | ||||||
| Manage Operations Videos | ||||||
| Manage Video Comments Videos |
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| Manage Tags | ||||||
| Edit Tags | ||||||
| Delete Tags | ||||||
| Assign Tags | ||||||
| Manage Categories | ||||||
| Edit Categories | ||||||
| Delete Categories | ||||||
| Assign Categories |
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| All Relationships are open to public. | ||||||
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| All Widgets are open to public. | ||||||
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| All Forms are open to public. | ||||||
| CAPABILITY | Administrator | Editor | Author | Contributor | Subscriber | Video Manager |
|---|---|---|---|---|---|---|
| All Views are open to public. | ||||||
Plugins are managed from the Plugins screen in the Administration Screens of your WordPress site. All Plugins listed on this screen are found in your wp-content/plugins directory. Each Plugin has a description in its header section of what it does, an author and website to refer to, and a version number. Find YouTube Showcase from the list.
To install your YouTube Showcase Plugin using the built-in plugin installer:
Replace VERSION in instructions with the version number of YouTube Showcase you want to install. After the activation, the YouTube Showcase plugin setup may display notification asking if you if you'd like to install setup pages or skip setup page installation, click the appropriate button.
To uninstall your YouTube Showcase Plugin using the built-in plugin installer:
WordPress auto-update system displays notification in the Admin Bar and also on the plugins page when new version of the YouTube Showcase is available.
To install the new version, simply hit the "Update automatically" button. WordPress will automatically download the new package, extract it and replace the old files. No FTP, removing old files, and uploading is required.
We offer different plugin editions to better match your needs. If you purchased a different edition of YouTube Showcase, follow the steps below to upgrade your plugin:
Upgrading YouTube Showcase Professional edition does not have any impact on your existing data but it is always a good idea to back up your WordPress database as a rule of thumb before any changes.
YouTube Showcase Professional edition is configured to work with many plugin extensions. Most plugin extensions work regardless of the edition unless specified specifically in the plugin page.
if you purchased a plugin extension, follow the instructions in WordPress Codex to install and activate your plugin extension like any other WordPress plugin.
If your extension comes with a license key, you must save and activate your license key to get software updates and support.
Keeping your plugin up-to-date is very important. At emdplugins.com, we regularly update our products to offer plugin or WordPress related bug fixes, product enhancements, patches for security vulnerabilities and more. Ability to receive these updates is critical to maintaining your software and site in working condition.
To be able to see the update notifications and receive updates, you must have a valid, activated license at all times. If your existing license is expired, you must renew it manually if you opted out of automatic renewals.
Please also note that you must have a valid license to get support for your plugin.
To activate your license:
If you followed the steps above and still are not able to get the plugin updates, there could be additional configuration needed for your site.
Administrators can import/export from/to CSV files or reset YouTube Showcase entities, taxonomies and relationships by clicking on Operations button in entity list pages. You must be able to get a backup of your content and files before starting importing/exporting or resetting. Operations page is divided into Import, Export, and Reset tabs.
Import tab is used to visually import existing records into an entity, its taxonomies and relationships. Each fields to be imported must be mapped to the app design.If you have custom fields in your CSV files, these fields can be imported as well. By default, custom fields are not mapped and they do not have a mapped label. You need to specify custom field's label in the corresponding textbox to import it correctly. The imported custom fields are created for every record with the corresponding value specified in the CSV file.
In you import large files with a lot of images or files attached, your server may be temporarily unavailable and return a white screen. This is due to the extended time needed by WordPress to process and create image thumbnails. If you get a white screen, open up a browser screen and monitor the activity in Media library. If you see images getting created, wait until all activity stops. After image or file addition stops, check if all your records are imported correctly. As a sanity check, you can do the import again but this time checking the Update existing data based on unique field(s) option.
Update option checks the existing records against the CSV file and see if there is a change. If there is a change, it finds the difference and updates the record. For example, if an image is added, the new image is added. If the incoming record does not include an existing image, the existing image which is not included in the incoming record gets deleted. All deletions are permanent. If the incoming record is not there, new record is created. You can use the update option to sync your existing records with external systems.
Export tab is used to export the content of an entity as a CSV file. If an entity has relationships, they must be exported separately from the main entity. You will see additional export buttons if this is the case. When you export records, all custom fields are exported as well.
Reset tab is used to permanently delete the content of an entity including all the attached images and files. You can also choose to delete all entity content, relationships, or taxonomies. Make sure you have a backup of your content, attached images and/or files before any reset action.
You can take a backup of your content to CSV using export tab. However, you need to take a backup of your attached files manually. In addition, if you need to re-import after the reset using the exported CSV, you must modify the URLs of your attached images to the new or backup location to import them back correctly.
Administrators can set global options available for YouTube Showcase. After logging in as administrator, click Settings page under Video Settings menu. Modify the ones you want to be changed and click Save button to make changes active. The following lists the available options:
The default entity base slug can be changed within entity tab of settings page in Video Settings menu. After you update, make sure to refresh your site's Permalinks under Settings. You can only change base slug if post name based permalink structure is selected.
For the most part, YouTube Showcase templates will integrate nicely with most WordPress themes. However you may run into issues when the default YouTube Showcase content wrappers do not match your chosen theme or your theme's CSS rules overwrite YouTube Showcase CSS rules.
Theme related issues manifest themselves by;
Theme related issues can potentially affect all single, taxonomy, archive and shortcode pages because YouTube Showcase uses templates of its own to display these pages and it’s impossible for eMDPlugins to know exactly what markup or CSS rules your theme uses.
There are three methods to resolve theme related issues;
If the issue can not be resolved through simply modifying the header and footer templates, you need to modify your theme's page.php.
Please note that this approach eliminates Your ability:
from Video Settings, settings page.
To set up this template page:
Next you need to find the loop (see The_Loop). The loop usually starts with a:
<?php if ( have_posts() ) :
and usually ends with:
<?php endif; ?>
This varies between themes. Once you have found it, delete it. In its place, put:
<?php yt_scase_pro_content(); ?>
You add custom CSS rules in the Custom CSS field of Tools tab under Video Settings menu, settings page to overwrite your theme's default CSS. The custom css rules added in the settings are not deleted when your plugin gets updated.
You can learn CSS language by completing the tutorials at w3schools.com
YouTube Showcase can be translated into any language by editing yt-scase-pro-emd-plugins.pot and yt-scase-pro.pot files.
Follow the steps below to fully translate YouTube Showcase into the desired language:
Screen Options is displayed as a hanging tab under the toolbar. Click on the Screen Options tab to expand the options available for a particular Screen, check (or uncheck) the desired options, then click the Screen Options hanging tab to collapse the Screen Options. Each screen may have a different set of Screen Options.
Edit page screen options allow the user to decide the edit boxes ,such as taxonomies, relationships or specific boxes such as authors, are presented in the edit area. You can turn on and off the ones that are not needed for a particular edit session.
List page screen options allow users to set the number of records displayed in the list table.
Shortcodes are small blocks of reusable code that can be inserted in a page to generate dynamic and often complex functionality. There is no limit in number of shortcodes that can be created and used. Multiple shortcodes can be used in the same page.
The following shortcode creates a Video Wall Gallery page with videos of Categories category.
[video_wall filter="tax::video_category::is::YOUR TAXONOMY VALUE;"]
The following shortcode creates a Video Wall Gallery page with videos of Categories category.
[video_wall filter="attr::emd_video_featured::is::YOUR ATTRIBUTE VALUE;"]
The following shortcode creates a Video Wall Gallery page with videos of Categories category where Featured is emd_video_featured .
[video_wall filter="attr::emd_video_featured::is::YOUR ATTRIBUTE VALUE;tax::video_category::is::YOUR TAXONOMY VALUE;"]
The following shortcode creates a Video Wall Gallery page with the published videos of Categories category where Featured is emd_video_featured in descending order by comment count, displaying 15 videos with no pagination.
[video_wall filter="attr::emd_video_featured::is::YOUR ATTRIBUTE VALUE;tax::video_category::is::YOUR TAXONOMY VALUE;misc::post_status::is::publish;misc::order::is::DESC;misc::posts_per_page::is::15;misc::has_pages::is::false;misc::orderby::is::comment_count;"]
Note: Replace YOUR ATTRIBUTE VALUE with the value stored for that attribute and YOUR TAXONOMY VALUE with the slug of the corresponding taxonomy value.
YouTube Showcase Professional comes with Visual Shortcode Builder(VSB) module which allows creating advanced custom shortcodes without manually writing code. To use Visual Shortcode Builder:
YouTube Showcase offers extensive customization options from plugin settings, settings page. The following customizations can be done without changing your theme's template files:
If your customization requirements are more complex and can not be resolved through the list of options provided above, you need to implement advanced customization techniques.
YouTube Showcase advanced customization can be done on 3 different areas;
Plugin customization can be implemented by using 4 different methods:
If you'd like to modify the functionality, you need to modify the plugin design (sold separately) using WP App Studio ProDev API access (sold separately and monthly development plans are available).
If you like to customize how HTML elements are to be displayed on screen, you can add custom CSS rules with higher specificity to your theme's style.css file.
If you'd like to customize layouts of YouTube Showcase, Please follow the steps below:
The layout files you added in the "emd_templates" has always precedence over the plugin's layout files. If the customized files get deleted, the layouts which came with your plugin are displayed. We recommend that you create a child theme if you'd like to minimize the risk of accidental deleting of the "emd_templates" directory because of theme updates.
The following layout file types can be customized:
YouTube Showcase labels and messages can be customized to better match your needs through language files. The customization is very similar to localization but recommended for US English users only. If your language is different than US English, you should localize instead of customize. The customization can be done for the strings included in yt-scase-pro-emd-plugins.pot and yt-scase-pro.pot files.
The following steps cover the string customization of labels and messages.
Follow the steps below to fully customize YouTube Showcase labels and messages:
All customization can be done by yourself or emarketdesign.com. Open a support ticket, if you prefer us to do the customization for you.
Below is the list of attribute and taxonomy definitions.
Global attributes can be set in the Settings page, Global tab under Video Settings menu.
YouTube video which may be displayed as single video, a collection of videos based on a video channel , custom playlist, or videos based on user defined search terms.
PL Playlist is a required field. Playlist does not have a default value. Indicates whether the video controls will automatically hide after a video begins playing. Fade out: The default behavior. The video progress bar will fade out while the player controls remain visible. Slide out: The video progress bar and the player controls will slide out of view a couple of seconds after the "video starts" playing. They will only \'reappear\' if the user moves her mouse over the video player or presses a key on her keyboard. Visible: The video progress bar and the video player controls will be visible throughout the video and in fullscreen.
Autohide is filterable in the admin area. Autohide has a default value of "'2'".Autohide is displayed as a dropdown and has predefined values of: 2, 1, 0.The video will autoplay when checked.
Autoplay is filterable in the admin area. Autoplay has a default value of "1".Sets a dark or light control bar.
Control Bar Theme is filterable in the admin area. Control Bar Theme has a default value of "'dark'".When checked, it disables the player keyboard controls. Keyboard controls are as follows: Spacebar: Play / Pause. Arrow Left: Jump back 10% in the current video. Arrow Right: Jump ahead 10% in the current video. Arrow Up: Volume up. Arrow Down: Volume Down.
Disable Keyboard Controls is filterable in the admin area. Disable Keyboard Controls does not have a default value.When unchecked, the player does not display the fullscreen button.
Display Fullscreen is filterable in the admin area. Display Fullscreen has a default value of "1".Sets if video annotations will be displayed by default or not.
Display Annotations is filterable in the admin area. Display Annotations does not have a default value.When unchecked, the player does not show related videos when playback of the initial video ends.
Display Related Videos is filterable in the admin area. Display Related Videos has a default value of "1".Sets the player\'s interface language.
Interface Language is filterable in the admin area. Interface Language has a default value of "'en'".Interface Language is displayed as a dropdown and has predefined values of: aa, ab, af, am, ar, as, ay, az, ba, be, bg, bh, bi, bn, bo, br, ca, co, cs, cy, da, de, dz, el, en, eo, es, et, eu, fa, fi, fj, fo, fr, fy, ga, gd, gl, gn, gu, ha, he, hi, hr, hu, hy, ia, id, ie, ik, is, it, iu, ja, jw, ka, kk, kl, km, kn, ko, ks, ku, ky, la, ln, lo, lt, lv, mg, mi, mk, ml, mn, mo, mr, ms, mt, my, na, ne, nl, no, oc, om, or, pa, pl, ps, pt, qu, rm, rn, ro, ru, rw, sa, sd, sg, sh, si, sk, sl, sm, sn, so, sq, sr, ss, st, su, sv, sw, ta, te, tg, th, ti, tk, tl, tn, to, tr, ts, tt, tw, ug, uk, ur, uz, vi, vo, wo, xh, yi, yo, za, zh, zu.When checked the player plays the initial video again and again.
Loop does not have a default value.When checked, the player does not show a YouTube
When set, the player begins playing the video at the given number of seconds from the start of the video.
Start Playing has a default value of "0".Sets the time the player stops playing the video in seconds from the start of the video.
Stop Playing After is filterable in the admin area. Stop Playing After has a default value of "3600".When unchecked, the player will not display information like the video title and uploader before the video starts playing.
Show info is filterable in the admin area. Show info has a default value of "1".Sets the color of the player\'s video progress bar to highlight the amount of the video that the viewer has already seen.
Theme is filterable in the admin area. Theme has a default value of "'red'".