Major Additions - 8WayRun.Com - Media Library

Don't forget to click INSTALL!
I'm an unemployed computer programmer... if you appreciate the work I have done on this mod, please don't hesitate in offering me a donation by clicking the "Support Developer" link to the right of this text. A donation of $50 or more automatically gives you the right to remove the copyright footer for this modification from a single forum.

This is a new modification, spawning from the old VB 3.x Video Directory modifications.
For all intents and purposes, both my old Video Directory Remixed mod, and Survivor's original Video Directory mod have been discontinued. Neither of us are maintaining these older versions, they will not receive any future updates and we will not be providing any support. This version has a new name because it has been completely rewritten from scratch and is not being built on Survivor's old code. Because of this, if you are upgrading to this new version, from the old version, be sure to read this entire post in order to understand the upgrade process.

What is this mod?
Simply put, this mod is a directory for media. It supports URL inputs, in order to extract meta data and directorize media into a simple and easy to understand library. Users can add their favorite media from a select few online distribution centers (such as Youtube or Vimeo) and categorize and tag them as they see fit. This mod offers rudimentary support for the hosting of local media. An administrator can upload a media to the /customVID/ (default) directory; then add the media to the library using the URL code of "local:filename". Media hosted locally will be displayed using JWPlayer, but will not provide meta data, so that kind of information will need to be entered manually.

Demo:

http://www.8wayrun.com/media.php

Features:

• Integrated directly into the vBulletin user database and product manager.
• Fully phrased and built on tempaltes for easy re-skinning and styling.
• Simple to use administration features and usergroup permission settings.
• Landing page with the most recent, most popular and highest rated media.
• Ability to add media into a single category, while adding multiple tags.
• Ability to browse media through categories, tags, and user contributions.
• Summary tag cloud with a link to the entire list of tags in the system.
• Comment and rating system based on AJAX including graceful degredation.
• Individual RSS Feeds for newest videos, categories, tags and user media.
• Search function for titles and descriptions.

Installation:

If you are upgrading from before version 1.1, please install that version first.

1. Upload all the files in the "upload" directory of the attached zip file to your forum root.
2. CHMOD the /customVID/thumbs/ directory to full read/write/execute 777 permissions.
3. CHMOD the /customVID/sitemap/ directory to full read/write/execute 777 permissions.
4. Import the product file called "product-medialibrary.xml" in the Product Manager of vBulletin.
5. Set your usergroup permissions and media library settings in your administration control panel.
6. OPTIONAL: Enable the "Generate XML Media Sitemap" scheduled task in your administration control panel.
   
   NOTES: Make sure you decide what you wish to use for your thumbnail quality setting. By default, thumbnails are saved at 50% quality. At 50%, thumbnails will only be 2kb in size, but at the expense of quality. At 100%, thumbnails will be about 15kb in size, but will have the highest quality. I recommend setting it to 80%, which would leave thumbnails at 5kb in size with still excellent quality.
   
   Every time you change your thumbnail quality setting, you will need to run the "Rebuild Media Thumbnails" to see any changes.

Upgrading from VDR:

1. The "video*" tables from your previous installation of VDR need to exist in your database.
2. Enable the "media ADMIN import" plugin in the plugin manager of your control panel.
3. Run the "Import Media from VDR" process in your update counters menu in maintenance.
4. Disable the "media ADMIN import" plugin in the plugin manager of your control panel.
5. Run the "Rebuild Media Thumbnails" process in your update counters menu in maintenance.
6. You may now uninstall VDR once you confirm everything has been imported as intended.
   
   NOTES: You will mostly likely get at least one error while rebuilding media thumbnails...
   
   When you get an error, click the details link for that media. If the media displays some sort of error such as "This video has been removed" or "This video no longer exist", then that means that media is gone and you'll be unable to generate a thumbnail for that particular media. Use the available options on that media's detail page to DELETE it from your library. Then go back to your browser window which is rebuilding thumbnails and click the "retry from this position" link.
   
   If you got an error for a media, but after clicking the details link you can find no obvious error with the video; then the error could have just been a simple syn/ack failure. Just click the "retry from this position" link and the system will try to rebuild that thumbnail again.

Known Bugs:

There is a conflict with this modification and some of Valter's VSA modifications that will prevent navbar permissions from being handled correctly. I don't know exactly who's fault it is; but I'm pretty sure there are no errors in my code that would be causing this problem. There is a work around for this however.

Admin Control Panel > Plugins & Products > Plugin Manager > "media NAVTAB"

Find the code:

    $perms = media_permissions();

Replace with:

$perms['rate'] = true;
$perms['comment'] = true;
$perms['submit'] = true;
$perms['playlist'] = true;
 
if (is_member_of($vbulletin->userinfo, explode(',','5,6')))
{
    $perms['modtags'] = true;
    $perms['modcategory'] = true;
    $perms['modservice'] = true;
}

[Jaxel]

================================================== =========
Version 4.1.5 MAINTENANCE RELEASE
================================================== =========

• CHANGES: Service Hosters can now retrieve XML information based on ERRORS.
  What this means, instead of YouTube returning a "Media contains invalid data" prompt,
  the script will instead post the direct error prompt supplied by YouTube Error Code.
  The issues people were having with foreign language forums and YouTube will be explained.
  
  • You MUST run the "Click here to restore all services in the "/media/xml" directory to their default settings" process.
    
• BUG FIX: Fixed service codes for MetaCafe and Dailymotion who changed their functions
• BUG FIX: Fixed a table prefix issue with both playlists and the search functions.
• BUG FIX: Disabled the ImageMagick routines once again until I can get it working.
• NOTICE: All install procedures pre-4.1.2 have been rolled up into the initial release.

================================================== =========
Version 4.1.5 PLAYLISTS AND CUSTOM VARIABLES
================================================== =========

• CHANGES: Object types are now explicitly defined in service XML files.
  
  • You MUST run the "Click here to restore all services in the "/media/xml" directory to their default settings" process.
    
  • The reason for this change is so that you can now host local WMV files using the included JW Silverlight Player.
    
  • The LocalAudio/LocalVideo services have been depricated and replaced with Local-MP3, Local-MP4, Local-WMA, and Local-WMV.
    
• NEW FEATURE: Administrators can now define up to 9 custom variables.
  
  • The custom variable system must be enabled in the control panel before you can use any custom variables.
    
  • Custom variables can be enabled or disabled by either adding or deleting their custom variable names.
    
• NEW FEATURE: Advanced Search can be found by clicking on the "Search" link on the sidebar.
  
  • The search function will now properly seperate search terms by spaces.
    
  • Advanced search will automatically include all enabled custom variables.
    
• NEW FEATURE: Users with permissions to do so, can now create public playlists.
  
  • A new usergroup bitfield has been added for this permission, so you may need to rebuild bitfields.
    
  • Playlists are not currently paginated, but at the same time, there is no limit to playlist sizes.
    
• BUG FIX: Fixed a bug where certain cells did not properly fill out the entire page.
• BUG FIX: Fixed a bug where comments could not be posted if pm inboxes were full.

================================================== =========
Version 4.1.1 STREAMING AND TEMPLATE FIXES
================================================== =========

• NEW FEATURE: You can now embed streams and chats from Justin.TV and uStream.
  
  • You MUST run the "Click here to restore all services in the "/media/xml" directory to their default settings" process.
    
• CHANGES: Moved the admin links 100px to the left for small fixed width forums.
• BUG FIX: Fixed the template bug where boxes wouldn't stretch to fit the page.
• BUG FIX: Fixed the browse media page for those forums that use TABLE_PREFIX.
• BUG FIX: Fixed thumbnail rebuilding for media that doesn't have per video RSS.
• BUG FIX: Fixed thumbnail creation for hosters that don't use JPG (GIF or PNG).

================================================== =========
Version 4.1.0 INCREMENTAL CHANGES AND BUG FIXES
================================================== =========

• NEW FEATURE: You can now import media directly from an installation of vBTube.
• NEW FEATURE: You can now import media with consolidated IDs from VD Remixed.
• CHANGES: All tags and tag content are now processed through the Data Manager.
• CHANGES: This mod is now once again 100% XHTML and RSS validated.
• BUG FIX: Foreign languages will now be processed correctly in AJAX comments.
• BUG FIX: Media Submissions will now properly follow autoforwarding links.
• BUG FIX: Main page will now properly hide videos in inactive categories.
• BUG FIX: XML will now FORCE the UTF-8 charset, so people should get less errors. This will make it so that you shouldn't have to change to UTF-8 to get this mod working. However, I still recommend switching to UTF-8 if you want to handle videos from some foreign sources.

================================================== =========
Version 4.0.9 EMERGENCY BUG FIX
================================================== =========

UPGRADERS:

• You MUST run the "Click here to restore all services in the "/media/xml" directory to their default settings" process.
  

• BUG FIX: The construct for the object/embed codes have been completely rewritten. They now use a universal template file, and store only the target SWF, instead of the entire object/embed construct. You MUST run the "Click here to restore all services in the "/media/xml" directory to their default settings" process if you want this mod to continue functioning. This change was put in to fix some errors in the MRSS sitemap.
• BUG FIX: The plugin to create the [media] bbcode for this mod has been encapsulated within a switch from a vb setting. There is a new setting in your Media Library options that operates this switch which will enable or disable the parsing of the [media] code. By default this switch is disabled; if you enable it and suddenly parts of your forum stop working (such as your CMS), then that means you have another mod installed on your forum that is conflicting with this one. I have gone through my code a dozen times trying to see if there is anything in it that would cause this problem and I could not find anything.

================================================== =========
Version 4.0.8 SUBSCRIPTIONS AND SITEMAP
================================================== =========

UPGRADERS:

• This version has changed the way the media bits are constructed. If you install this version and suddenly notice you are getting an error when browsing the media library, just go into your admin CP and reselect your media bit style.
  
• The sitemap has been expanded to support ALL videos in your media library. Because of this, a new directory was created in /customVID/sitemap; please make sure this directory is CHMOD 777 in order to use the sitemap.
  
• Also remember to update your .htaccess file, and check the new entries in the known bugs section for permission changes for those using VSA mods.
  

• NEW FEATURE: Users can now sort media by rating, favorites, comments, views and dateline.
• NEW FEATURE: Users can now subscribe to media, they will recieve a PM when a comment is posted.
• NEW FEATURE: A BBCode called [media] has now been implemented for posting from the library.
• NEW FEATURE: A Scheduled Task has been added to build your sitemap. (disabled by default)
• BUG FIX: Ampersands will now get replaced in strings properly for services such as MySpace.

================================================== =========
Version 4.0.7 BIG BUGFIX ROLLUP
================================================== =========

UPGRADERS: If you are upgrading to 4.0.7 follow these steps:

1. Delete the entire directory /media and all files within it.
   
2. Upload contents /upload folder of ZIP file to your forum root.
   
3. Import product-medialibrary.xml as a product, allow overwrite.
   
4. Run http://URLtoYourForums/media.php?do=admin_host_restore
   

• NEW FEATURE: Service Hosters now support secondary service values! This is important for video hosters such as Hulu which purposely obfuscate their embed codes.
• NEW FEATURE: Submission form for media will now validate fields.
• NEW FEATURE: Category Descriptions will now parse BBCode.
• CHANGES: Service Hosters no longer require semicolons at the end of fields.
• CHANGES: Regex now use # delimeters, so / no longer needs to be \ cancelled.
• BUG FIX: Comments and Editing boxes have been fixed! This issue was related to the guide here on vb.org being wrong about how to valdiate WYSIWYG textboxes. As a temporary fix, a plugin has been installed that will completely disable WYSIWYG options inside of the Media Library.
• BUG FIX: ~E_DEPRECATED has been removed, since it has been depricated... oh irony.
• BUG FIX: Loading media details will no longer prompt a javascript error for favorites.
• BUG FIX: Thumbnail compression will now default to GD only, until I can find a fix for ImageMagick.
• BUG FIX: Tags will now strip the following characters from any entry:
  

  # $ ? & @ % + = ^ | : ; / \ < > { } [ ]
  
  These characters are reserved URI characters and were giving problems with tags. This fix will fix any NEW tags, however this will not affect your existing tags. I recommend everyone to head to their administrate tags panel and delete any tags which contain any of these characters.
  

• BUG FIX: More miscellaneous code and template revisions...

================================================== =========
Version 4.0.6 FAVORITES AND WIDGETS
================================================== =========

• NEW FEATURE: Users can now give hearts to media and mark them as favorites.
  

  Any usergroup with permissions to rate, will have permission to mark favorites.

• NEW FEATURE: User Profile Tab for most recent media.
  

  This uses the new "tiny" bit; which is selectable as the main bit in admincp.

• NEW FEATURE: Widget support for both the ForumHome Sidebar and the vbCMS.
  

  This has been updated since the previous versions, so please update your codes.

• BUG FIX: Fixed formatting buttons on quick reply for comments.
• BUG FIX: Fixed MySQLi errors for those who happen to be using it.
• BUG FIX: Fixed service constructs for non-SEO slugged links.
• BUG FIX: Fixed RSS feeds for tags in table prefix settings.

================================================== =========
Version 4.0.5 SERVICE HOST XML REWRITE AND SITEMAP
================================================== =========

• NEW FEATURE: You can now add new services by developing your own XML files.

  I will write a guide on how to construct these XML files soon enough, but for now, you'll have to figure it out on your own.

• NEW FEATURE: Google Video Sitemap now available at "media.php?do=sitemap".

  This sitemap will only parse LOCAL audio and video files.

• BUG FIX: Fixed some leftover thumbnail problems from the previous version.
• BUG FIX: Miscellaneous SQL and template errors no one knew about but me.

================================================== =========
Version 4.0.4 XHTML VALIDATED AND THUMBNAIL REWRITE
================================================== =========

• CHANGE: Thumbnails are now stored in "/customVID/thumbs/" (default) directory.

  UPGRADERS: If you are upgrading to 4.0.4 from a previous edition of this mod, you can now delete all the "/customVID/0-9/" thumbnail folders, but should make sure to CHMOD the "/customVID/thumbs/" folder to 777. In addition, upgraders will be required to run the "Rebuild Thumbnail Process" to generate thumbnails in the appropriate folder.

• CHANGE: Administrate Services control panel is more streamlined for editing.
• CHANGE: This mod is now 100% XHTML certified using the W3C XHTML Validator.
• NEW FEATURE: You can now enable/disable the autoplay feature in media.

  UPGRADERS: If you are upgrading to 4.0.4 from a previous edition of this mod, you must MANUALLY make changes in your services to handle the new "autoplay" setting. The new Administrate Services page will make this update process easy. Just read THIS POST and copy and paste the recommended embed codes into the appropriate Edit Service page.

• NEW FEATURE: You can now host media locally on your server! Media must be uploaded to the "/customVID/" (default) directory. Then you can add the media to the library by using the codes "localvideo:filename.ext" or "localaudio:filename.ext" as the Media URL on the submit form. You can also add subdirectories inside of "/customVID/"; so if you uploaded "/customVID/intros/SC2intro.mkv", you can add it as a video to your library with "localvideo:intros/SC2intro.mkv". Media hosted locally will be displayed using JWPlayer, but will not provide meta data, so that kind of information will need to be entered manually.
• BUG FIX: Comments and Descriptions will now parse URLs into BBcode.
• BUG FIX: Auto-Create Threads will now properly update forum last post times.
• BUG FIX: Deleting a media will now properly delete the assosciated thumbnail.
• BUG FIX: Fixed report page for those not using Search Engine Optimization.
• BUG FIX: Fixed RSS Feeds for those not using Search Engine Optimization.

================================================== =========
Version 4.0.3 AUTO CREATE AND VERIFICATION FEATURES
================================================== =========

• NEW FEATURE: The Auto-Create Thread feature has once again returned!
• NEW FEATURE: Tag, Comment, Description and Title verification handlers now follow built in vB4 settings. Each of these fields will follow their related forum setting such as "Tag Minimum Length" or "Tag Maximum Length". If a field should fail to meet the specifications, the error handlers will now explain why it has failed in more detail.
• BUG FIX: Fixed information retrieval for feeds with non-Latin sources.
• BUG FIX: Fixed phrasegroup error within AJAX functions created in 4.0.2.
• BUG FIX: Miscellaneous SQL and template errors no one knew about but me.

================================================== =========
Version 4.0.2 MASSIVE TEMPLATE REWRITE
================================================== =========

• NEW FEATURE: StyleVar group has been created to handle Media Library styles.

  This is a complete overhaul of the template system for this mod. Every old template has been replaced with new templates which include stylevars, and a new naming structure. I used replace functions in Notepad++ in order to replace the template calls in all the files so there shouldn't be any errors; however, please inform me if there are any issues with this new version, whether it be a template not being called correctly or even unchached templates.

• BUG FIX: Fixed htaccess QSA errors were page numbers were not being processed.
• BUG FIX: Fixed avatar constructs for comments due to a bug within vB4 itself.

================================================== =========
Version 4.0.1 SECURITY UPDATE AND BUG FIX ROLLUP
================================================== =========

• CHANGE: Added lines to htaccess to convert VDR URLS to Media Library URLS.
• NOT A BUG: Navbar permissions not processing.
  
  • Make sure you are running the most recent version of vBulletin 4x.
    
  • There are TWO permission groups for this mod. Make sure you set BOTH.
    
  • Permissions work fine on my test forum with no other mods installed.
    
  • None the less, I created a function to process all permission values.
    
• BUG FIX: Fixed a XSS EXPLOIT with the tagging system and single quotes.
• BUG FIX: Fixed Implicit GROUP BY error with certain versions of MySQL.
• BUG FIX: Fixed various TABLE_PREFIX bugs in places without datamanager.
• BUG FIX: Fixed CSS construction for people using "stylesheets as files".
• BUG FIX: Fixed datamanager call for description length when rating media.
• BUG FIX: Fixed media phrasegroups when making calls to ajax functions.

[Jaxel]

reserved....

[Jaxel]

================================================== =========
HOW TO MAKE YOUR OWN SERVICE HOST XML FILES WITHOUT RSS FEEDS
================================================== =========

Coming back soon...

[Veer]

Excellent product Jaxel. Rated, Installed and Nominated

Keep up the good work, Thumbs up!

[Juggernaut]

Tagged.

[l7azat]

installed ...
is this version will be work with VB 3.8.X .. ??

[Bannec]

Thanks Jaxel.
Great Job!

[kho91]

thank you, installed, rated anf MOTM

[Riccardo83]

Everything works perfect, except u see html code for & and other symbols like

TV &amp; Performances

on some pages. In the drop down menu it is displayed correctly tho.

http://www.alizee-forum.com/media.php