EnterMedia Tutorials

Cleaning out old versions

2011-07-29T15:13:14Z

So if you enable version control you may want to clean out old .versions files. At one time we had a way to do this with an online tool but sometimes it is easier just to run a UNIX script and clean out the file system directly.

Here is a general purpose script that cleans out files depending on the parameter you pass in. Be careful with it.

Save this file as clean.sh

Then to call it use sh clean.sh .versions


#!/bin/bash

echo "Deleting files in current directory" 
pwd

if [ "$1" = "" ]
then
  echo "Usage: Pass in the file names to delete"
  exit
fi


string=$(echo $@ | awk '{gsub(" ", "|")}1')
eval find . -regextype posix-extended -regex "\"./.*(${string})$\""   | while read NAME
do
 echo "FILENAME : "$NAME
 PATH=${NAME%/*}
 NAME=${NAME##.*/}
 echo "FILENAME PATH : " $PATH  
# echo "You do the rest"  
/bin/rm -rf "$PATH/$NAME"
done

Active Directory Single Sign-on

2010-10-05T19:50:21Z

1. Use the FileManager to edit this file:

/media/authentication/logon.xconf

It should contain this setting:

<property name="authenticationserver">localhost</property>

This is the server that is the primary Active Directory server.

2. You can either let the user enter a domain or you can add a specific domain:

<property name="domain">Workgroup</property>

If no domain is used the authentication will do a local authentication onto the Windows machine that the web server is running on.

3. Once authenticated a user can be automatically created in the system then added to a default group. This property can be edited or added to the login.xconf file:

<property name="autologingroup">users</property>

How To: Use the sample Rest API client

2010-10-05T19:50:23Z

EnterMedia provides a simple Rest API for external systems to interact with it. This API also allows developers to create their own User Interface (UI). To demonstrate how to use EnterMedia's REST API, we've developed a sample terminal client in Java. This way developers can easily start a new EnterMedia client project.

Downloading

The sample java client is distributed as a zip file. You can get this file directly from our website. The file includes:

Source code
Eclipse project and classpath files, so you can import it directly into your workspace
Apache Ant build file, ot make it easier to build the client
All required libraries, including the client itself as a jar file
A readme file, in HTML, with usage instructions and examples
Javadoc files

Building

The bundle comes with an Ant build file so you can just run it to build the client. If you are not using ant, you can just use plain javac to compile the classes in the src folder, passing in all the jar files in the lib directory into the classpath.

Running

The most basic way of running the sample client is by just invoking the Java virtual machine, passing along the right arguments. That is, telling it that the classpath contains all the jar files in the lib directory and that the main method is in the com.entermedia.ui.ConsoleClient class. This should look like:
java -cp lib/commons-codec-1.3.jar:lib/commons-httpclient-3.1.jar:lib/commons-logging-1.1.jar:lib/dom4j-1.6.1.jar:build/compile com.entermedia.ui.ConsoleClient <args>

A better way of running it is using ant:
ant -Dcommandline="<args>" run
this will take care of building the client and setting the right classpath for it.

Finally, an even easier way of running the client in linux is using the included javaclient.sh script:
sh javaclient.sh <args>
this script requires a JAVA_HOME environment variable to be set.

For more information about the arguments for the client please look at the readme.html file inside the docs folder, in the zip file.

EnterMedia Release's Version 6.706, Includes Online Video Platform Support

2010-10-05T19:50:24Z

EnterMedia Release's Version 6.706, Includes Online Video Platform Support

Centralize your Enterprise Media Library with EnterMedia

OpenEdit Inc., released open source EnterMedia media asset management, version 6.706. This newest release includes online video platform, capability to build and email collections, a new user interface, security improvements, improved uploader and more.

Two new features are featured below, Online Video Platform and Collections.

ENTERMEDIA ONLINE VIDEO PLATFORM

Entermedia Online Video Platform allows you to securely play videos on your website without using 3rd party streaming companies.

EMAIL COLLECTIONS TO OTHERS

Collaborate with others by emailing a link to your Collection. Granular permission based controls allow email recipients to access only what you want them to. Email recipients do not need to be EnterMedia users.

EnterMedia version 6.706 Release Notes

User Interface

The application has a new nicer looking header and easier navigation. In an effort to simplify our results page, we have removed all of the icons displayed under thumbnails. This gives a cleaner appearance and allows us to fit more thumbnails on a single results page. All of the actions that were previously available via icons below thumbnails are not available on the Media Viewer page, which is accessed by clicking on any thumbnail.

We also changed our image hover functionality. Previously the enlarged hover image would follow your mouse around until your pointer left the thumbnail. Apparently people found this irritating, so we changed it! The hover will now stay centered above the thumbnail and shows the item name and selection groups. For anyone who is still annoyed by the image hover functionality, you can set your preferred view to "Gallery-No Hover". See "View Settings" below for information on setting your view preferences.

Security Improvements
Catalogs now has asset and folder level security enabled by default. Also improved the security editor on the catalog settings page.

Collections
Assets can now be added to groups of collections. A collection gives you a way to show off your best or most recent assets.

View Settings

We also removed the hits-per-page, view, and sorting dropdowns from the results header. These settings are now accessible from the "view" button in the results header. This button will give you a pop-up which allows you to set your results view preferences based on the type of results you are seeing: Category (browsing), Search, Album, or Selection.

New Video Player
EnterMedia is now using FlowPlayer (http://www.flowplayer.org) to better support previewing of video assets. If you upload a video, EnterMedia will now generate:
1. A series of still thumbnails to be displayed on results pages. If you hover your mouse over the thumbnail of a video, it will begin to cycle through this series of still images.
2. A flash version of the video for previewing. By clicking on the thumbnail you will be taken to the Media Viewer page where you will be able to watch the entire flash version of the video!
3. Ability to import from YouTube or external URL to an asset or video file

Note: Generating thumbs and flash versions of videos requires ffmpeg (http://www.ffmpeg.org) to be installed and configured correctly to work with EnterMedia. For more information on this, see our installation instructions here:
http://entermediasoftware.com/docs/AppendixA/index.html

Selecting Improvements
The new clipboard groups are designed to help users sort their media. Once you have added a group of similar items into a clipboard group, you can then categorize or keyword all of those items at once using multi-edit, or you can add the items to a posting to share it with your friends. We have tried to make these clipboards a little easier to use so that everyone can take full advantage of their capabilities. To that end, we have added Drag and Drop functionality! From a results page, you can now drag and drop a thumbnail into a clipboard group box to add that item. You can also add a single item to a selection group using the check boxes that appear in the hover image, or you can add an entire page of results to a selection group by clicking the "Clipboards" button in the results header.

Share with Facebook
We have added a button on the Media Viewer page that will share an item with Facebook!

Voting
From the MediaViewer page, you can now click the star button to indicate that you like that photo/video/whatever. You can even see a list of other users who like a given item.

New Uploader
We have a new, fancier-than-ever upload applet. You can now upload multiple items, or even an entire folder, all at once. EnterMedia will immediately create assets for each item being uploaded, allowing you to begin sorting or editing the meta-data associated with your uploads. You will see an indicator in the top-right corner showing your current uploads. You can click on this indicator to see the progress of your current uploads. Thumbnails will be created for your new assets as the uploads complete. (You will need to navigate around the site, or at least refresh your page before you will actually see the images.)

ABOUT ENTERMEDIA

EnterMedia is the only JAVA, open source media asset management solution with a video online platform. Upload your Enterprise Media Library's videos, photos and documents into a secure centralized server. Your media server running EnterMedia can be branded to meet your company's design and functionality goals.

EnterMedia is free to download. http://entermediasoftware.com/download.html

For more information go to http://entermediasoftware.com or email julie@openedit.org

Enabling Watermarking

2010-10-05T19:50:27Z

With EnterMedia, you can watermark all images in all catalogs or pick and choose what catalogs should have watermarked images. You can also configure where the watermarks are placed on the image.

Enabling Watermarks

In EnterMedia you can have very fine-grained control over what gets watermarked. I will give examples on how to watermark specific images all they way up to watermarking the entire site.

Single Catalog
You can enable watermarking for a single catalog through the Security UI. To do this, follow these steps:
- Go to the settings area of your EnterMedia site.
- Choose the catalog you want to watermark from the "Edit Catalogs" list.
- Go to the "Security" tab
- Find the "forcewatermark" permission
- If there is an "edit" link next to "forcewatermark", click it. Otherwise, click "override", then find the override version of "forcewatermark" at the top of the list, and click "edit" there.
- Change the value to "True" and click the "Save" button.
Other watermarking options require editing some XML manually. More information is listed below:
Site-Wide Watermarking
- File to Add Property to: "/webapp/entermedia/catalog/_site.xconf"
- Property to Add: "<property name="forcewatermark">true</property>"
Specific Sized Images
- File to Add Property to: "/webapp/WEB-INF/base/entermedia/catalog/downloads/preview/{size}/_site.xconf"
- Property to Add: "<property name="forcewatermark">true</property>"
Sizes:
- thumb - 150x150 - thumbnail used on results page.
- medium - 300x300 - image used as the hover image.
- large - 600x600 - download size option.
- cache - 800x600 - image used on media viewer page.

Watermark Placement

Just as you have fine-grained control over what gets watermarked you also have fine-grained control over where the watermark is placed. Setting watermark placement is very easy all that is involved is modifying properties in XML files. See the chapter titled Online HTML/Text Editing , for more information on editing files in EnterMedia.

Watermark Position Options
- north
- northeast
- east
- southeast
- south
- southwest
- west
- northwest
- center
- tile
- Site-Wide Watermark Position
  
  File to Add Property to:
  
  /webapp/WEB-INF/base/entermedia/catalog/_site.xconf
  
  Property to Add:
  
  <property name="watermarkplacement">{position}</property>
- Specific Catalog Position
  
  File to Add Property to:
  
  /webapp/media/browse/{catalog name}/_site.xconf
  
  Property to Add:
  
  <property name="watermarkplacement">{position}</property>
- Specific Sized Image Position
  
  File to Add Property to:
  
  /webapp/WEB-INF/base/entermedia/catalog/downloads/preview/{size}/_site.xconf
  
  Property to Add:
  
  <property name="watermarkplacement">{position}</property>
NOTE: If the forcewatermark or the watermarkplacement properties are set in multiple files the most specific file will determine how the watermark is applied. For example, the properties set on a specific sized image will override properties set for all catalogs.
Location of Watermark Image

The image used for watermarking is /webapp/WEB-INF/base/themes/darktabs/entermedia/images/watermark.png. If you would like to use a different image for watermarking you can either replace the previously mentioned image, or if you created your own theme, create an image called watermark in /webapp/WEB-INF/base/themes/{your theme}/entermedia/images. For more information on creating your own theme see the chapter on theme creation.

EnterMedia Tutorials

Cleaning out old versions

Active Directory Single Sign-on

How To: Use the sample Rest API client

Downloading

Building

Running

EnterMedia Release's Version 6.706, Includes Online Video Platform Support

Enabling Watermarking

Enabling Watermarks

Single Catalog

Site-Wide Watermarking

Specific Sized Images

Watermark Placement

Watermark Position Options

Site-Wide Watermark Position

Specific Catalog Position

Specific Sized Image Position

Location of Watermark Image