Skip to main content
MindTouch Success Center

Use a Media Repository (Private)

A media repository, which is an optional method to manage files and images in MindTouch, makes it easier to reuse files or images throughout your site and update reused media in one location.

Set up a media repository

There are two ways to set up a media repository:

  • Create a media repository pages - works on any MindTouch site.
  • Import a media repository pages - works for some older MindTouch sites created before November 2017 that show Options > Import here in the MindTouch toolbar.

Create a private Category to house your media repository

To insure your media repository remains hidden from pagination, you will want to create a private Category. 

  1. Navigate to the desired Category level location for your media repository.
  2. From the MindTouch toolbar, click New > Category, select the Create live radio button, and click Create.
  3. In the Page Title field, enter Media Repository.
  4. Click Options > Restrict Access. Choose the private option and add any users and groups you want to have access to the media repository through navigation and search. 

Organize your media repository

Now that you've created a private location for your media repository we will begin setting up Semi-Private Categories to house your media.  It is best to think of how you would like to organize your. Here are a couple different examples to get you started:

By Product By Media Type Match you Site Structure
  • Media Repository
    • Product A
    • Product B
    • Product C
    • etc
  • Media Repository
    • Images
    • PDFs
    • etc
  • Media Repository
    • Homepage Category 1
    • Homepage Category 2
    • Homepage Category 3
    • etc 

By Product

  • Media Repository
    • Product A
    • Product B
    • Product C
    • etc

By Media Type

  • Media Repository
    • Images
    • PDFs
    • etc

Match you Site Structure

  • Media Repository
    • Homepage Category 1
    • Homepage Category 2
    • Homepage Category 3
    • etc 

Option 1: Create a media repository pages

These steps will walk you through how to setup the Categories to build-out your media repository structure

  1. Navigate to your media repository page.
  2. From the MindTouch toolbar, click New > Category, select the Create live radio button, and click Create.
  3. In the Page Title field, enter the page title to match the structure your decided on.
  4. In the top right corner of the first DekiScript container ("Description: Search field"), click the X to remove it from the page.
  5.  On a new empty line, click Style > CSS from the editor toolbar and enter the following code:
    div#pageText .mt-category-container.mt-subpage-listings-container {
     display:none;
    }
    .columbia-article-topic-category .elm-attachments{
        display:block !important;
    }
    
  6. On a new empty line, click Style > DekiScript from the editor toolbar and enter the following code:
    if(#page.subpages > 0){
        "The following is a list of sub-pages within this Media Repository:";
        wiki.tree();
    }
  7. Click Save.

Media-Repository-Code.png

  1. Repeat steps 1 - 7 for each section of your media repository hierarchy. 

Option 2: Import a media repository page

To confirm you can use the import method, check the MindTouch toolbar for Options > Import here. If you do not see the Import here option, follow the steps above to create a media repository page instead.

  1. Download the media repository MTARC file.
  2. Navigate to the desired Category level location for your media repository.
  3. From the MindTouch toolbar, click Options > Import here.
  4. Find your media repository MTARC and select it to import.
  5. Repeat steps 1 - 4 for each section of your media repository hierarchy.

Set permissions

The Categories within media repository should be set to Semi-private, so Pro members can access it but end users can only view images that are attached to the page (not see the page in navigation or search).

  1. Navigate to each of the Categories within your media repository, click Options > Restrict access and select Semi-Private.
  2. Add any users or groups that will need access to the different sections of your media repository to manage files
  3.  

    If you've setup any subpages within any of the Categories in your media repository Category, select Apply restrictions settings to all to subpages and Overwrite all existing permissions on subpages to the ones set on this page.

     

     

Media repository organization tips

  • First identify the structure of the documentation you are going to create. Consider adding a media repository page to top-level Category pages to organize media for each Category.
  • MindTouch pages, including media repository pages, can only display up to 1,000 file attachments. If you anticipate you will add more than 1,000 files into a media repository page, create similar sub-pages main media repository as needed.
  • After you create a media repository page, add new files or move files to the media repository page.

Add files from media repository to your pages

  1. Open the page into which you want to insert a file or image in Edit mode.
  2. In the editor toolbar, click the Image icon.
  3. Browse to your media repository or search by the file's name.
  4. Click Save image.
  • Was this article helpful?