Using our Drupal Module
Our official Bits on the Run Drupal Module is a great tool for publishers using the Drupal CMS for their sites. This module enables uploading, searching and embedding videos - directly from within the Drupal content editor.
Note this version of the Bits on the Run Drupal module only works with Drupal 7. If you're still on Drupal 6, you should download this module and follow the installation instructions in the included readme.txt.
Installation
Follow these steps to install the module:
- Download the BOTR Drupal module and unzip.
- Copy the resulting folder to the appropriate module directory (for example, the sites/all/modules subdirectory of your Drupal installation).
- Make sure the PHP cURL library is installed. See this page for more info, or ask your system administrator.
- Set $base_url in the settings file of your Drupal site (if you don't know which one, edit sites/default/settings.php).
For example, if your site is located at http://mysite.com/drupal, the line should be:
$base_url = 'http://mysite.com/drupal';
- Go to Administer » Site Building » Modules, scroll to the Video section and check the enabled box for the Bits on the Run module. Save your configuration.
- Go to Administer » Site Configuration » Bits on the Run and insert your API key and secret. These can be found in the account tab of our dashboard. Save the configuration. It should look like this:
- Go to Administer » Site Configuration » Text Formats » Configure Filtered HTML and check the Bits on the Run quicktag replacement box. Save the configuration. By editing the Bits on the Run quicktag replacement settings, you can enable or change the timeout for signed links, the DNS mask of the content server and the default video player.
- Go to Administer -> User -> Permissions to configure the permissions to allow user groups to use the BOTR plugin.
Your integration between Drupal and Bits on the Run is now set up!
Posting
With the setup completed, you will see a new Bits on the Run widget when you're adding or editing content. It contains a list of videos in your account, and an option to upload additional videos.
The widget is shown on the edit page of all node types by default, and inserts the video quicktags into the body field. If you want to choose a different target you can change the settings for the node type. Go to Structure -> Content types and modify the target and weight settings of the Bits on the Run widget settings. Leave the target empty if you want to hide the widget, or enter the DOM id of the desired HTML widget.
Your 5 newest videos are shown. Use the inline search field to find other videos. Click on a video to insert it into your post. By default, the widget will be displayed for all node types, and will insert video quicktags in the body text area when you click a video in the list.
The video upload works exactly like within BOTR. You can set a title for the video and browse for the original file on your computer. When submitting the upload, a bar will display the upload progress. After the upload has completed, the uploaded video will appear at the top of your video list.
Signing
BOTR videos are embedded in a document with a so-called quicktag. Here's an example:
[bitsontherun MdkflPz7]
Our plugin will convert this quicktag into an embed code when the post page is displayed to a visitor. As part of this, our plugin can also sign your embed code, in case you have enabled the player security settings in your BOTR account.
The setting for the signing timeout can be found with the other BOTR settings (Configuration » Text Formats » Filtered HTML). By default, signing is disabled (timeout = 0). This because Drupal's caching interferes with the signing. If you don't use caching, or make sure to set your signing timeout larger than the caching time, you can enable the signing by setting a timeout > 0.
Players
Videos are embedded in the default player you configured in the input format settings. Changing this setting will change the player for all videos embedded in fields using that input format.
However, it is possible to override this setting and have a video embedded with a specific player. Therefore, also insert the key of the player you want to use in the quicktag:
[bitsontherun MdkflPz7-35rdi1pO]
You can find the key of your players in the dashboard player section.