Documentation and Guides for the Drupal - Kaltura Module. [1]
When creating a new node using the Drupal Kaltura Module and adding a video to it, the status of the video is automatically set as "Published". sometimes it is necessary to set the default status to "Not Published" so that we will be able to moderate the content.
Open the file includes/Kaltura.notification.inc
Find the function:
Function Kaltura_notify_node_entry_add
find the following line
$node->status=1;
and change it to:
$node->status=0;
Media uploaded to Kaltura system can be managed from within Drupal management system as well as from Kaltura Management Console (KMC). Sometimes it is necessary to synchronize these systems to make sure media content is up-to-date on both systems and to enable synchronized workflows. Synchronization between Kaltura and Drupal is done in several ways, and in various scenarios. Below are few examples to such synchronization use cases.
The Kaltura Drupal module allows admins and users to delete content. However, content deleted from Drupal (i.e. deleting Drupal nodes) is not removed from the Kaltura databse. Content will continue to be accessible through the Kaltura Management Console while it won't have a corresponding node on the Drupal site.
Some partners find it useful to be able to delete media from the website and the actual database simultaneously instead of deleting files from their Drupal site and then login to Kaltura Management Console and delete again.
Please note: the module is built that way as Kaltura believes deleting the actual content should be done by admin only, and not by users even if they are registered as the content owners.
In order to implement the simultanous deleting, follow these steps -
a. Create a new module (or add to existing kaltura_nodeapi())
b. The new module implements a single hook – hook_nodeapi
c. This hook acts upon "delete" action, and if the node deleted is of type "kaltura_?", it calls "delete_entry" in Kaltura's API
As instructed in Kaltura’s module README file, after you unzip Kaltura’s module into your Drupal modules folder, you need to copy the crossdomain.xml file from its original location at the Kaltura modules folder into the root directory of your domain. If your domain is www.domain.com then the crossdomain.xml file should be copied to http://www.domain.com/crossdomain.xml.
Yes. To complete the installation of Kaltura All-in-one video module for Drupal, you need to register to Kaltura partners program. This could be done during installation process, when you are directed to Kaltura registration page, or you can go to Administer > Site Configuration > Kaltura > Server Integration Settings and as a partner. Your Kaltura partner information will be automatically saved into module’s configuration, and will be sent to you in an email as well.
If you previously registered to Kaltura, and already have your partner identifiers, there is no need to register again. At the Kaltura Server Integration Settings page, click the “Click here if you already have a Partner ID” link and just put your partner information to complete your installation process.
Yes. Kaltura implements a set of notifications, sent from Kaltura servers to your Drupal website. These notifications update your Drupal website with the status of your media. In order to support server side notifications, your server must be publicly available on the internet:
Please go to Administer > Site Configuration > Kaltura > Server Integration Settings > Kaltura to Drupal Notifications Settings and put your Drupal base URL: http://www.yourdomain.com. This will configure your notification url. For password-protected site, you should set the notification URL as http://user:pass@yourdomain.com/. Kaltura will concatenate a /?q=kaltura/notification_handler string to this base URL to have a direct link to the notifications handling functionality. In addition to your URL settings, you should check the ‘Enable server side notifications’ option at the notification settings form.
It is recommended that you verify (using an HTTP sniffer) that the notification URL returns HTTP 200 and does not redirect traffic to another URL. Redirection will cause notifications to miss their destination.
The most common reason for such problem is that your crossdomain.xml file is not available at the root directory of your domain. To correct this problem, copy the crossdomain.xml file from Kaltura’s module folder into the root directory of your domain.
The most common reasons for such a problem are:
If you wish to limit the number of items displayed within the various drupal media views provided by Kaltura, Go to Administer > Site Building > Views. From the views list, choose and edit the relevant Kaltura view. At the ‘Edit’ screen set the ‘Items per page’ basic settings to the number of items you want to appear within the view.
Kaltura offers self-hosted solutions using the Community and Enterprise Editions.
To learn more about this option please go to Kaltura Community Edition project [4] page.
Please visit the FAQ [5] for more info.
This category contain a set of guides describing how to tweak and modify the KCW widget within the Drupal-Kaltura module.
The Kaltura Network Terms of Use can be reviewed here [10]. However, when hosting the content locally the user may change those terms of use. In order to do so:
$flashVars["terms_of_use"] = "http://corp.kaltura.com/tandc";$flashVars["terms_of_use"] = "Full URL to your terms of use page";
Customizing the appearance and functionality of Kaltura’s drupal contributor wizard is possible either as a self-customization project or as a Kaltura professional services project.
Please look for information on self-customization at the KCW project documentation [11] and Kaltura-Drupal forums [12], or contact Kaltura’s sales team [13] to issue a professional services request.
On both cases you will obtain a new UIConf ID for the customized contributor wizard. For using this UIConf ID to replace drupal’s default contributor wizard, please follow the following steps:
With this tutorial, you'll be able to configure the Contribution Wizard to use preexisting templates or create your own!
Step 1. Overview
Open your KalturaCE database and locate table "ui_conf". Each row here, is a setting for a specific Kaltura widgets. Rows with IDs 380, 501, 502, 503, 504, 601, 602, 610, 36200, 36202 represent different settings for Contribution Wizard.
Each row has a "conf_file_path". This url (minus the "/web" prefix) is the URL to the configuration file, which you can additionally modify/tweak.
Step 2: Changing the Theme (ID)
Open {drupal}/modules/kaltura/kaltura_client/kaltura_settings.php and locate
This tells Drupal to go into KalturaCE database, table "ui_conf" and use ID 601 (mentioned in step 1).
Try changing the above code to
It tells Drupal to use ID 602. Contribution Wizard is now dark.
Try out other IDs. This way you can also get rid of an ad at the end of the Contribution Wizard.
Step 3. Further Editing
To remove Audio, Picture upload tabs, disable import from YouTube, Facebook, remove Terms of Use pop-up, you will have to edit the configuration (xml) file of the widget.
For this, I suggest you duplicate the row from "ui_conf", relating to KCW. Then duplicate the configuration (xml) file (the file listed in "conf_file_path"). Make sure that the ID you're using is not currently being used and update the path to your configuration file in "conf_file_path". Now edit the configuration file for final changes.
Top update the Terms of Use link, see this post [9].
You can also recompile *.SWF files with custom styles and text (translate, etc) using Adobe Flex by downloading the KCW package from here [14], editing the source code and compiling it via command line (see the included buildResourceModules.bat file).
The following guide will explain required steps to remove the "Add Interactive Video" option from the KCW widget with in the Drupal-Kaltura module.
kaltura.module file and find the kaltura_list_entries() function.<li [16] id="tab-kaltura"><a [17] href="'. $_GET['cwurl'] .'">Add Interactive Video</a [17]></li [16]>
<li [16] id="tab-kaltura_browse"><a [17] class="current" href="'. url('kaltura/entries/allow-insert/'. $field_id) .'">Browse Interactive Videos</a [17]></li [16]>
<li [16]><a [17] href="#" onclick="window.top.kalturaCloseModalBox();return false;">Close</a [17]></li [16]>
</ul [15]>
$add_existing = '<div id="media-upload-header"> and remove the following lines:<li [16] id="tab-kaltura"><a [17] class="current" href="'. url($_GET['q']) .'">Add Interactive Video</a [17]></li [16]>
<li [16] id="tab-kaltura_browse"><a [17] href="'. url('kaltura/entries/allow-insert/'. $field_id, array( 'query' => array( 'filter' => $add_filter, 'cwurl' => url($_GET['q']) ) )) .'">Browse Interactive Videos</a [17]></li [16]>
<li [16]><a [17] href="#" onclick="window.top.kalturaCloseModalBox();return false;">Close</a [17]></li [16]>
</ul [15]>
The uploader (KCW) that comes with the Drupal module has one uploader configuration with 3 tabs - Image, Video and Audio. follow this guide if you want to change this configuration to only images (if your site has only images) or to split the uploading flows to three different flows (for example - image uploader separate from video uploader).
Function kaltura_contribution_wizard() is always called with one argument. The argument should be a serialized PHP associated array.
The array is being converted into variables, so the key is the variable name, and the value is the variable value.
For example, if the array has an element like: 'test_key' = 'my_value',
Then in the function, the variable $test_key will be defined, and will contain the string "my_value".
In that manner, one more element could be "uiconf_id", which its value will change according to the upload context.
In the same function, there is a call to function getContributionWizardUrl().
If a UIConf ID is passed to that function, the returned value will be a URL on Kaltura server that will load CW with that UIConf.
kalturaInitModalBox js function, most of those will call a URL of kaltura/contribution_wizardkaltura_contribution_wizard(), add the variable in the call to getContributionWizardUrl()you should have
(assuming the key in the parameters array is 'uiconf_id')
after this line, add:
Kaltura’s Drupal player could be customized from the Kaltura Application studio tab at the Kaltura Management Console (KMC) application. To customize your drupal player login to the KMC [19] (or your own hosted KMC) and switch to the Application Studio tab to create a customized player. After you save your new player, use its player ID to replace drupal’s player settings by following the steps below.
You will now have to change 2 of the files that are included in the Kaltura Drupal module.
kaltura_client/kaltura_settings.php.Open kaltura_client/kaltura_settings.php and find the $kdp_widgets array within the KalturaSettings class.
'video' array; Add your own custom widget or adjust an existing line for the player skin you are using, e.g. if you are using the dark player skin, adjust the following line :to include your customized UIConf ID:
Kaltura\includes\kaltura.themeing.inc on line 556.By removing the string .'_'. $uicid, so it looks like this:
You can also just replace the line by doing a copy-paste from this guide.
For advanced customization and for custom built players, refer to the KDP guides [21] or contact Kaltura sales team [13].
Customizing the appearance and functionality of Kaltura’s drupal Standard Editor is possible either as a self-customization project or as a Kaltura professional services project.
Please look for information on self-customization at the KSE project documentation [22] and Kaltura-Drupal forum [23], or contact Kaltura’s sales team [13] to issue a professional services request.
On both cases you will obtain a new UIConf ID for the customized Editor. For using this UIConf ID to replace drupal’s default Standard Editor, please follow the following steps:
define [24]('KalturaSettings_SE_UICONF_ID', 603);define [24]('KalturaSettings_SE_UICONF_ID', Your customized UIConf ID);The module allows you to set the default size for Media Node and Remix Node.
In case you want to display players in different sizes for the same node type, you have to do it through template.php theme override or in the relevant .tpl file.
Using template.php:
Assuming your theme is called "mytheme", you can implement an override function that returns the rendered HTML for a certain item.
For this example, I'll assume that we need to set different sizes for Media Node.
- First, we will declare the function in template.php file:
- This function should return a kaltura special tag of the following structure:
You should set the width/height according to the context.
Recommended – look at the original function (in this case, in plugins/node_kaltura_entry/node_kaltura_entry.module), you might want to copy most of the code and add your own changes where needed.
Using .tpl file:
Assuming you have template file for Media node type, with the name of node-kaltura_entry.tpl.php
This function can include the HTML that will be displayed when rendering a Kaltura media node.
In the same manner as the first method described above, you should create the kaltura special tag with the wanted values,
Than call kaltura_replace_tags() function, passing it a string variable that contains the special tag.
In both methods, the tag will be replaced with the embed code with the wanted size.
Links:
[1] http://http://pramcenter.net
[2] http://www.kaltura.com/lib/pdf/KMC_Quick_Start_Guide.pdf
[3] http://www.kaltura.org/screenshot774-2009-06-01-075918jpg
[4] http://www.kaltura.org/project/kalturaCE
[5] http://www.kaltura.org/faq-all-one-video-module-please-read-first
[6] http://www.kaltura.org/how-use-more-one-uploader-kcw-your-drupal
[7] http://www.kaltura.org/how-remove-add-interactive-video-option-drupal-kcw
[8] http://www.kaltura.org/how-customize-drupal-contributor-wizard
[9] http://www.kaltura.org/how-change-terms-use-link-drupal-contributor-wizard
[10] http://corp.kaltura.com/tandc
[11] http://www.kaltura.org/kcw-contribution-wizard
[12] http://www.kaltura.org/forums/client-side-and-widgets/kcw-contribution-wizard
[13] http://corp.kaltura.com/about/contact
[14] http://www.kaltura.org/project/kcw
[15] http://december.com/html/4/element/ul.html
[16] http://december.com/html/4/element/li.html
[17] http://december.com/html/4/element/a.html
[18] http://www.php.net/isset
[19] http://www.kaltura.com/index.php/kmc
[20] http://www.php.net/array
[21] http://www.kaltura.org/kdp-dynamic-player-and-playlist-widget
[22] http://www.kaltura.org/kse-simple-editor
[23] http://www.kaltura.org/forums/applications-and-cms-extensions/drupal-kaltura-module-all-one-video-module-forums
[24] http://www.php.net/define
[25] http://www.kaltura.org/edit-entry-player-broken