[RC] YouTube Videos Mod

[keith10456]

Modification Name: YouTube Videos Mod
Author: keith10456

• Special thanks to kas5986 for the Css tips.
• Special thanks to Solidjeuh for the Vertical Video Results contribution.
• I also want to thank the mod team members for their tips (Paul, DavidIQ, Unknown Bliss, and marc1706).

Modification Description: Adds a YouTube Videos page to your phpBB website. Your members will be able to view and search any/all of the videos on YouTube, and create a custom playlist from the results. Playlists are created by simply dragging and dropping video thumbnails to a box. In addition, visitors can view videos while searching for videos at the same time (without ever leaving your website). The mod utilizes YouTube's video API, Quvic search engine, MOVYX video browser, and Tyzen's YouTube script.

Modification Version: 2.0.1

Features:

• Easy to install. No database changes.
• View and search all videos on YouTube (without leaving your site).
• Create custom playlist by dragging and dropping video thumbnails.
• Tags that generate videos of popular search terms.
• Hot Trends videos that automatically update from YouTube.
• Ability to add/load videos from a specific User on YouTube.
• Ability to add/load videos from a specific YouTube Playlist.
• Clean easy to use user interface.
• Displays "Who's Online" info.
• Displays "View Online" info.
• Subsilver2 support.
• Search results appear without having to leave or reload the page.
• Search results stay on the screen even when viewing the video (so you don't have to search again).
• Thumbnail display of video's playback time (shown on search results thumbnails).
• Displays the number of results in your video search.
• Easily navigate through the search results using "Next" and "Back" buttons.
• Quick links for Recently Featured, Top Rated, Most Viewed and Most Popular videos.
• Embed and link options appear once video stop playing.

Demo URL: Click here for the demo.

Modification Download: Click here to download the mod.


Upgrade Instructions:
See Question 1 in the Frequently Asked Questions post in this topic.

Notice: As with any mod, before you install this mod be sure to make a back-up of your phpBB files and database (this mod does not make database changes).


Change Log:

Code: Select all

Version 2.0.1
* Add - Ability to view View Online information.

Version 2.0.0
* Add - Ability to create custom playlist by dragging and dropping videos.
* Add - Tags that generate videos of popular search terms.
* Add- Hot Trends videos that automatically update from YouTube
* Add - Ability to add/load videos from a specific User on YouTube.
* Add - Ability to add/load videos from a specific YouTube playlist.

Version 1.0.8
* Add - Page Title to videos page.
* Add - Displays the number of results in your video search, and the page that you're on (in the results).
* Fix - Code clean-up on videos page.
* Change - Improved the button display on videos page.
* Change - Hover effect on video thumbnails.

Version 1.0.7
* Fix - Style bug that caused videos to overlap off of page.
* Fix - Code typos and settings on videos page.
* Change - Created separate language file to make installation easier (less edits to phpBB core files).
* Change - Style settings to make installation easier (less edits to phpBB core files).

Version 1.0.6
* Fix - Language variable typo.

Version 1.0.5
* Fix - Instructions in subsilver edits.

Version 1.0.4
* Fix - Updated jquery.
* Fix - Root path info in overalheader file.
* Change - Added blue background to video page.
* Change - Moved subsilver instructions to contrib folder
* Fix - Link in header.

Version 1.0.3
* Fix - Corrected mod validation errors.

Version 1.0.1
* Fix - Numerous validation errors.

Version 1.0.0
* Add - Thumbnail display of video's playback time (shown on search results thumbnails).
* Add - Auto-hide menu bar (that displays the play/pause and other video options).
* Fix - Install instructions to make mod Auto-Mod compliant.

Version 0.1.1a
* Add - Added Subsilver2 support.

Version 0.1.1
* Add - Added a link to the overall_header.html file.
* Fix - Language variable edit.
* Fix - Cleaned-up a little css
* Fix - A couple of html mistakes in the videos page.
* Fix - Mistake in the install instructions.

Version 0.1.0
* Initial release

[keith10456]

FREQUENTLY ASKED QUESTIONS


1 - How do I upgrade from the previous version of the mod?

Upgrading from 1.0.6 through v2.0.1:

• See the "contrib" folder in the download.

Upgrading from Versions 0.1.1 - 1.0.5:

• Undue the file edits for includes/functions.php; language/en/common.php and styles/prosilver/template/overall_header.html
• Delete all files in the following directory: /root/youtube/
  
  • if you're using a subsilver2 based style, in addition to the edits above, be sure to undo the edits for styles/subsilver2/template/overall_header.html.
• See the "contrib" folder for subsilver2 instructions.
• Go to ACP and select the "Styles" tab. Then Refresh your "Templates", "Themes" and "Imagesets". Be sure to clear your Browser's cache.

Upgrading From Version 0.1.0:

• Undo all edits.
• Delete the folder /root/youtube
• Follow the instructions in the install file of the download.

2 - Does this mod support subsilver?
Yes.


3 - How do I restrict access to the Videos page to logged-in members only?
Open: /root/youtube.php

Find:

Code: Select all

// Start session management
$user->session_begin();
$auth->acl($user->data);
$user->setup('mods/youtube_lang');

After Add:

Code: Select all

if ($user->data['user_id'] == ANONYMOUS)
{
    login_box('', $user->lang['LOGIN']);
} 

4 - How do I make the "Videos" link in the overall_header viewable to logged-in members only?

Open: /root/styles/prosilver/template/overall_header.html

Find:

Code: Select all

				<!-- YOUTUBE VIDEOS MOD BEGIN -->
				<li class="icon-yvm"><a href="{U_YOUTUBE_VIDEOS_MOD}" title="{L_YOUTUBE_VIDEOS_MOD}">{L_YOUTUBE_VIDEOS_MOD}</a></li>
				<!-- YOUTUBE VIDEOS MOD END -->

Replace With:

Code: Select all

				<!-- YOUTUBE VIDEOS MOD BEGIN -->
				<!-- IF S_USER_LOGGED_IN -->
				<li class="icon-yvm"><a href="{U_YOUTUBE_VIDEOS_MOD}" title="{L_YOUTUBE_VIDEOS_MOD}">{L_YOUTUBE_VIDEOS_MOD}</a></li>
				<!-- ENDIF -->
				<!-- YOUTUBE VIDEOS MOD END -->

5 - Can I remove the links that are applied to the Videos page?
No. Removing the links will violate the script's terms of use and copyright.


6 - How do I add this mod to a style other than prosilver?
Copy the "prosilver" folder in the download and rename it to the exact name of the style you're using.

• Upload the copied folder to the following directory: /root/styles/
• In the install instructions, apply the edits for "overall_header.html" to the overall_header.html file of the style you're using.
• In the install instructions, apply the edits for "bidi.css", "buttons.css", and "colours.css" to the files of the style you're using.
• Upload the edited files. Go to the ACP, select the "Styles" tab. Refresh your "Templates", "Themes" and "Imagesets". Clear your Browser's cache.

7 - How do I uninstall this mod?
Reverse the edits given in the install file. The edited files include:

• /root/viewonline.php
• /root/includes/functions.php
• /root/styles/prosilver/theme/bidi.css
• /root/styles/prosilver/theme/buttons.css
• /root/styles/prosilver/theme/colours.css
• /root/styles/prosilver/template/overall_header.html

Delete from your server:

• /root/youtube (delete entire "youtube" folder)
• /root/youtube.php
• /root/language/en/mods/youtube_lang.php
• /root/styles/prosilver/template/youtube.html
• /root/styles/prosilver/theme/youtube.css
• /root/styles/prosilver/theme/images/youtube_videos_mod.png

8 - Can I use this mod with the Social Network mod?
Yes. If you're having compatibility issues:

Open

Code: Select all

root/styles/yourstyle/template/overall_header.html

Find And Remove

Code: Select all

<script type="text/javascript" src="http://code.jquery.com/jquery-latest.js"></script>

9 - What versions of phpBB is this mod compatible with?
The mod was tested on versions 3.0.8, 3.0.9, 3.0.10, 3.0.11, and 3.0.12.


10 - How do I change the Page Title of the Videos page?
Open

Code: Select all

/root/language/en/mods/youtube_lang.php

Find

Code: Select all

	'YOUTUBE_VIDEOS_MOD_PAGE_TITLE'                  => 'YouTube Videos',

Replace With

Code: Select all

	'YOUTUBE_VIDEOS_MOD_PAGE_TITLE'                  => 'Your_Text_Here',

Note
Replace Your_Text_Here with whatever you want the Page Title to be (DO NOT remove the quotes).

[4_seven]

Nice api and a new "most wanted"
It's my choice to modulize mods. It is easy plugged to phpbb core.
The way of hooks or derivate (non-phpbb3) with a minimum of core touch is the right way.
Congrats..

[darkonia]

agree very nice mod

[keith10456]

Thanks

[heredia21]

incredible mod!

[keith10456]

incredible mod!

Thank you

[keith10456]

God willing, tonight I'll update the mod with some css clean-up, an icon, and put the link for the overall_header in the install instructions.

[darkonia]

thanks for the update xD

[Mess]

Looks good.

[keith10456]

Unfortunately, I got caught-up with the Simple Audio Player mod. I'll try to get back to this tonight.

@ Mess - Thanks!

[aaronfluffy]

Before installing how do I put in my own videos to the script?

[darkonia]

Before installing how do I put in my own videos to the script?

the mod is not for your own videos its only to search youtube videos, read the infos in the first post!

[keith10456]

Before installing how do I put in my own videos to the script?

the mod is not for your own videos its only to search youtube videos, read the infos in the first post!

Correct

[keith10456]

Mod Updated To Beta Version 0.1.1

Update instructions are in the "contrib" folder of the download. The download link is in the 1st post of this topic. I also updated the FAQ post (2nd post in this topic).

Enjoy