Wordpress Install

The vPIP Wordpress Plugin places links to the vPIP scripts and style sheet into the header section of the blog page. With those links, either the Media Entry video and audio entry areas or the the code generator ("Generate vPIP HTML Code" app) is available below where you write the blog entry.

In addition, the Media Entry features in vPIP expand on Rudy Jahchan's UFOSplode custom wordpress code. This is covered on the Using Media Entry page.

Here are the steps to install vPIP on Wordpress:

1. Download the vPIP plugin in vPIP.zip by clicking the --> vPIP link <-- and "Save ... As" to a location on your hard disk. Then, get the vPIP Feeds widget in widgets.zip by clicking the --> vPIP Feeds widget link <-- and "Save ... As" to on your hard disk.
   Previous Releases:
   • version 1.12 plugin & feeds widget
   • version 1.11
   • version 1.10

   

Note: vPIP is a javascript application in the vpip.js file. The current version of vPIP is at the top of the vpip.js file. The plugin version visible in Wordpress and the vPIP.php file is different version number referring to just the plugin, vPIP.php.

2. Extract vPIP.zip to create the vPIP folder and the widgets.zip to create the widgets folder. Upload them to your ../wp-content/plugins location of your Wordpress installation.
   Note: If you have a prior install of vPIP it's probably a good idea to erase it first to not have any extra old files hanging around. But, you can overwrite older versions without cleaning them off. Make sure to copy any custom images you've created for vPIP back into this install.
• If your using Wordpress 1.5, in admin mode go to Options->Writing and uncheck "WordPress should correct invalidly nested XHTML automatically".

  

• If your using Wordpress 2.x and the Media Entry interface, then you'll be fine using the visual rich editor. Otherwise, as Admin go to Users->Your Profile and uncheck "Use the visual rich editor when writing*". Then go to Options->Writing and uncheck "WordPress should correct invalidly nested XHTML automatically". If your users will also be using the vPIP plugin without Media Entry, also uncheck the Users from using the visual rich editor by default*.

  Note: The Media Entry interface is on by default when installed. The Using Media Entry page covers the Admin options for setting the Media Entry interface.

  
  • * If you want to use the Visual Rich Editor without Media Entry, then you'll need to place the vPIP code in the HTML entry area when writing a post. Use the HTML button to access the HTML entry area.

    

3. Go to Plugins and activate vPIP.

   

4. Below where you'll be writing your post, the Media Entry interface will appear by default. Just enter your image and video files here. For usage instructions, go to the Using Media Entry page.
   

   Otherwise, if you've turned off Media Entry in the Options->vPIP Config menu, then code generator ("Generate vPIP HTML code" helper app) is available.

   

   From this you can specify the movie files (Quicktime, Windows Media and/or Flash) and their display parameter. Then the "Generate Code" button will provide the vPIP HTML code to paste into your blog entry.

   Note: This Flash app will sometimes hold the cursor from typing back in the write box. In that case open the app externally with the "Open in external window: vPIP" button.

5. You are now ready to use vPIP in writing blog posts and pages. To do that, go to the Using vPIP page.
6. If vPIP doesn't work, then your theme header template probably doesn't support inserting the script from the plugin. In that case, manually put in the reference to the script by
   1. going to Presentation->Theme Editor
   2. Select the Header template.
   3. Place the following line before </head>:
      

      <script src="http://[url where vPIP was uploaded to]/vpip.js" type="text/javascript"></script> <style type="text/css" media="all">@import "http://[url where vPIP was uploaded to]/vPIPBox.css";</style> <script src="http://[url where vPIP was uploaded to]/jquery.js" type="text/javascript"></script> <script src="http://[url where vPIP was uploaded to]/vpipit.js" type="text/javascript"></script>
      Replace [url where vPIP was uploaded to] with the Wordpress directory location you uploaded vpip.js to in step 2 above. For example, the location could be http://mysever/wp/wp-content/plugins/vPIP/vpip.js

      Note: Don't include the script line for vpipit.js above if you don't want movie links that are not already set to vPIP, to be automatically set to use vPIP.

      

The vPIP Plugin menu at "Options->vPIP Config" allows you to control how vPIP works on your blog

1. If you uncheck "Use the Media Entry interace for media entry and theme display?", then the Media Entry interface when writing your post is disabled. See the Using Media Entry page for details.
2. If you uncheck "When supported by theme, insert vPIP javascript links into page <HEAD> section", then the vPIP scripts will not be automatically placed in the header of your blog. You will need to place them there yourself to activate vPIP.
3. If you uncheck "Automatically make movie links work with vPIP", then movie links not setup with vPIP will be automatically set to run vPIP.
4. If you uncheck "Enable ThickBox", then the ThickBox scripts will not be included in the <HEAD> section" and ThickBox will not run.
5. If you uncheck "Show vPIP Code Generator", then the vPIP Code Generator will not appear below the text entry box to write your blog post.
6. "Use vPIP bracketed code" is for making vPIP work with WordpressMU (Wordpress Multi-User). When checked, the vPIP Code Generator will create bracketed code. And the vPIP plugin will convert that to regular vPIP HTML code when the web page is rendered.
7. If the vPIP Plugin is located in another location then listed under "vPIP Plugin location", change to the URL here.

For writing vPIP HTML instructions, read the Using vPIP page.

Comments have move to the vPIP google groups discussion area. Please join there for any questions, problems or suggestions.