From Develop

Jump to: navigation, search

Have a question not answered here? Email us at questions@mirocommunity.org.

Return to Miro Community Manual homepage


Creating Your Miro Community Site

You can create a hosted Miro Community site at http://www.mirocommunity.org/signup . To create a site, fill out Username, Password, Password confirmation, URL, and Email, and hit "Create my site." Your Miro Community site should then be up and running, and you should receive a confirmation email at the address you entered.

Available account levels are:

If you're interested in discussing an enterprise contract, please feel free to get in touch by emailing anne [at] pculture.org.

Adding Videos

When you arrive at your Miro Community site, the first thing you'll want to do is start adding videos. When you "add" a video to Miro Community, it means that you are embedding the video onto your Miro Community site. Videos themselves are hosted elsewhere, and must be publicly available in order to work with Miro Community.

There are two main ways to add videos to Miro Community - one at a time, or by adding a "source" which will bring in multiple videos to your site over time.

Adding a Single Video

To add a single video to your Miro Community site, click the "Submit a Video" button at the top of each user-facing page. You can also click "Submit a Video" in the "Videos" section of the admin-facing portion of the site.


You may enter any valid URL into the Submit window.


For videos from Youtube, blip, or Vimeo, entering the video URL will automatically pull the video meta-data (such as description, thumbnail, date, title, author and tags) from the host site and generate the appropriate embed code. You will then be given the opportunity to add additional tags.

For video files, such as .mov or .ogg files (e.g. http://upload.wikimedia.org/wikipedia/commons/d/dd/Annie_Oakley_shooting_glass_balls%2C_1894.ogg) you will be asked to fill out the metadata information manually, including Title, Description and other information.

For URLs that are not recognized (other video host providers or other websites, such as http://www.whitehouse.gov/blog/2010/11/20/weekly-address-new-start-treaty-fundamental-security), Miro Community will request that all metadata be entered manually, including the embed code for the video. You can often find the embed code by looking on the video player for a "share" or "embed" link, and can then copy and paste that code into the appropriate box. If the embed code given has the video width being over 540px, the video player will spill over onto other parts of the video page, so you may want to consider re-sizing it.

If you are logged in as an administrator when you submit a video, your video will automatically appear on your Miro Community site. If you added the video manually, the date may not be accurate - you can edit this on the video page. You can also attribute the video to an author, place the video in a category, and edit any other metadata you would like to change.

To change the embed code of a posted video, you will need to go to the Bulk Edit page.

The videos submitted by other people will go to the Review Queue to be moderated by an administrator. When a video is submitted by a registered, logged-in user, Miro Community notes the username and the email address associated with this user as the contact for the submitted video. Videos submitted by a logged-in user are visible on the user's profile. Users also have the opportunity to enter in any Notes regarding their submission (these will be visible only to site administrators). Those users who are not logged in will have the opportunity to enter their email so that administrators may contact them about their submission.

Adding a Source (Feed of Videos)

To add a video source which will continuously bring in videos to your site, go to the Manage Sources page in the admin-facing area of the site (i.e. http://yoursite.mirocommunity.org/admin/manage/).

User Feeds from YouTube, blip.tv, and Vimeo

If you would like to add the videos of a user on YouTube, Vimeo, or blip.tv, click "Add Feed" and paste in the URL for that user's profile page (e.g. http://www.youtube.com/user/MoMAvideos , http://vimeo.com/storycorps). Miro Community will automatically convert this URL into a Media RSS feed of that user's video uploads.


Next, Miro Community will ask you to Review the feed before you add it and add any categories that describe the feed as a whole. You can also use this step to attribute the feed to a particular author. Miro Community will list the URL of the feed and the number of videos discovered.

The most important part of this step is whether you choose to "Approve All" or "Review them first." If you approve all, all videos in the feed will become public as they become embedded on the site, both those currently in the feed and any new videos that will be added later. If you choose to review these videos first, they will go into the Review Queue. You may change this setting for a feed at any time on the Manage Sources page.

You also have the choice to have videos from this feed not appear automatically on the front-page of your site in the "New Videos" area. You might want to select this option if the feed you're adding is particularly prolific at updating and you don't want to drown out other items, or if you would like your front page to be highly curated but still want this material available through the site.


At this point, you have the option to add the feed to your site, or cancel it. If you add the feed, importing meta-data for videos in the feed may take some time. When the feed has finished importing, you will be given the option to see the videos, moderate them, or return to the Manage Sources page, depending on whether you chose to review videos before approving them or not.

Later, you can edit or remove added feeds at any time through Manage Sources page.

Media RSS Feeds

You can add other kinds of video sources by pasting in the Media RSS feed.

Learn more about Feeds at the Miro User Guide and Make Internet TV.

The RSS feed will need to have media enclosures (specifically, video files) in order for videos to be embedded on your site.

After adding the feed, proceed as with user feeds.

Saved Search

A third way to bring videos into your site is by searching video host sites through Miro Community and saving the search results. Follow the instructions for Searching for Videos, then choose "Save Search."

The search results are based entirely on what Miro Community receives from YouTube and blip.tv. We have noticed that blip.tv results are often out-dated. This is a known issue.

Search for Videos

You can search for videos by Keyword on the Manage Sources page of your Miro Community site (http://yoursite.mirocommunity.org/admin/manage/). Searching through this interface will return results from YouTube and blip.tv. You can choose to organize search results by the latest results or the most relevant. We have found that blip.tv queries do not return results properly sorted by date.

Once your search results return, you can review videos from the search and choose to Approve, Feature, or Moderate the results by adding those items to the queue.

If you would like results from this search to regularly come in to your review queue, you can choose to "Save as a Source."

Featuring Videos

Once you have videos on your site, you should choose some to feature. The front page of your MiroCommunity site includes a featured, or "Editor's Picks" area on its top, so if you don't feature any videos, this area will be empty.

Administrators can feature videos from the Review Queue, the Bulk Edit page, or the video page itself.

Featured videos are listed on the Featured page and in the Featured/Editor's Picks area, depending on the site theme. In the default themes, featured videos are listed on the Featured page and in the featured section with the date they were Featured on.

Editing Video Information

Sometimes, you might want to change the metadata for a video, such as the title or date. When logged in as an administrator, you can do this when a video is in the review queue (click the gray edit links), on the video page, or on the Bulk Edit page. If you want to edit multiple videos at once, use the Bulk Actions menu on the bulk edit page with the desired videos selected.

Miro Community pulls in the metadata for some videos as it appears when videos are imported. If this metadata becomes (if ever) edited on the host site, Miro Community will not automatically check and update it. So, if it is important to you that video metadata remains up to date, you can ask video creators to contact you about any changes they make, and/or check back on videos that seem to be initially lacking information. Miro Community will warn you if you add a single video that seems to be missing some material.

Next Step: Organize Your Content

Return to Miro Community Manual homepage

Personal tools