VideoPress » Related Videos

VideoPress Related Videos

The VideoPress Related Videos Wordpress Plugin allows publishers, like you, to add related videos to your posts. (Each post gets its own set of related videos.)

Downloading

To download, click the download link below.



download


It's a tarball. (It's in .tar.gz format.)

Installing

The tarball which this plugin comes in contains 1 directory. Put that directory in your Wordpress press plugins directory. (I.e., put it in "wp-content/plugins".)

That's all you have to do to install. (But you still have to activate it.)

Activating

Once it's been installed, Wordpress will auto-detect it.

However, you still need to activate it for it to work. Go to the Wordpress Admin Plugins page and do so.

Using

Once you have it installed and activated... you can add related videos to your page in one of two ways.

Either add it as a Widget...

Or manually add any of the following code...


        <?php do_action('videopress_related_videos');?>
            

...into the "single.php" file of you template. (Where ever you put that is where the related videos will show up in your post.)

Developers can also get at the related videos via the Wordpress global variables: $post and $posts. As in...


        $post->related_videos
            

or...


        $posts[i]->related_videos
            

You can drill down into either of these to get stuff like...


        $posts[i]->related_videos[n]->href
        $posts[i]->related_videos[n]->title
        $posts[i]->related_videos[n]->thumbnail->href
        $posts[i]->related_videos[n]->thumbnail->width
        $posts[i]->related_videos[n]->thumbnail->height
            

Remember to configure this plugin first, by going to Options → Related Videos to pick the width and height of the video thumbnails you are going to use, etc.

Theming

Theming is an advanced feature of VideoPress Related Videos will probably never do. Theming VideoPress Related Videos is only relevant for people who are create custom WordPress themes. (If you are not, then you can ignore this section.)

VideoPress Related Videos allows certain parts of it to be themed. For example, the summary popups can have their look and behaviour themed.

This is done by adding special files to your theme (in a special directory). The 2 files are called "summary.css" and "summary.js".

So, for example, if the WordPress theme you are using is at: "wp-content/themes/mytheme/". Theme what you'd do to customize the summary popups is...

#1: Create a special directory in your theme called "videopress-related-videos/". So, if you theme is at "wp-content/themes/mytheme/", then this special directory would be "wp-content/themes/mytheme/videopress-related-videos/".

#2: Create a special CSS file called "summary.css". So, if you theme is at "wp-content/themes/mytheme/", then this special CSS file would be "wp-content/themes/mytheme/videopress-related-videos/summary.css".

#3: Create a special JavaScript file called "summary.js". So, if you theme is at "wp-content/themes/mytheme/", then this special CSS file would be "wp-content/themes/mytheme/videopress-related-videos/summary.js".

NOTE: You do NOT have to do both #1 and #2 -- you do NOT have to create both the "summary.css" file and the "summary.js" file. You could just create one. (Most people who choose to customize this will probably only create a "summary.css" file -- will probably only create the special CSS file.)

You can look at the default summary.css for guidance on how to create your customer summary.css file.





VideoPress Related Videos is part of Show in a Box... making Wordpress the ultimate videoblogging platform.

Some work for this was supported by and conceived by Jay Dedman.