Categories

From KickApps Documentation

Jump to: navigation, search

Contents

Overview

Categories/sub-categories are classifications that enable you and your site's members to group similar assets for easy finding, viewing, sharing and management purposes. Categories can be applied to all audio tracks, blog posts, custom pages, groups, photos, sets or videos stored in your KickApps site, in addition to external URLs that you have registered in your KickApps account.

Only the Webmaster and Admins can create categories and sub-categories. Category/sub-category names must have at least one character and cannot have more than 30 characters.

There is no limit to the total number of categories and sub-categories you can create. Each category can have up to 3 levels of sub-categories. (For instance Sports > Football > Leagues > Teams)

Creating Categories/Sub-categories

Categories can be created in the Affiliate Center on the Configure > Settings> Media Categories page.

To create a new Top-Level category simply type in the name for the category in the text box under the "Create a new Top-Level Category" section. You can also create a group with the same name by checking the "create group with same name" check box.

Add_Category.png


To create a sub-category, click on the top-level category that you would like to add a sub-category to, and then simply enter the name of the sub-category. You can also create a group with the same name by checking the "create group with same name" check box.

Add_Subcategory.jpg


To create a sub-sub-category click on the category, that you would like to add a sub-sub-category to, and then on the sub-category page click the sub-category you would like to add a sub-sub-category to. Once the sub-category is selected simply type the desired name for the new sub-sub-category under the "Create a new Sub-category section"

New_SubSub_Category.png


You can add sub-categories up to sub-sub-sub-category level for each top-level-category.

Editing or Renaming Categories/Sub-Categories

To edit a Top-level category simply click on the category name and the click on the "edit this category" link.

EditCategory.png


To edit a sub-category click on the sub-category you would like to edit and then click on the "edit this category" link.

Edit_Category_Page.png

Delete Categories

To delete a category, click on the name of the category you want to delete, then click the link to "Remove this category."

Note: You can only remove categories that do not have any sub-categories. In order to delete categories that have sub-categories you must delete the sub-categories first.

Remove_Category.png


Once a category is deleted all assets that are assigned to this category will lose the classification.

Assigning categories to assets

Categories can be applied to audio tracks, blog posts, custom pages, external media items, groups, photos, sets, videos.

You and your site member's can assign categories/sub-categories that you have created to media items ( audio tracks, blog posts, custom pages, external media items, photos, sets, videos) via the upload/edit media pages.

Upload_Page.png


Groups can be assigned to categories/sub-categories under the create group section of the Affiliate Center.

Create_Groups_Page.png


Categories/sub-categories can also be applied in the Affiliate Center on any media, member or group details page.

Media_Details.png

Searching on Categories

Once a media is assigned to a category you can see a clickable category name on its "play page" which the users can click on to find more items that belong to the same category or its sub-categories.

Play_Page.png

Categories in Feed Builder

You can also create RSS feeds, using the feed builder interface, which filter the results based on categories.

Feed_Builder.png

Categories and APIs

RSS APIs

In the RSS API you can use the "categories" param to filter for results that have been assigned to the media categories and sub-categories.

For more information on RSS API, click here

REST APIs

Using the REST APIs you can manage (create/retrieve/update/delete) all your categories.

You can also use the search REST API to filter search to have media items that belong to a category.

To see a complete list of KickApps Rest APIs, click here

Related Tutorials and How-to Articles

How To Make A Dropdown Box For Categories

Make a Category Required on Photo Upload