Categories
From KickApps Documentation
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.
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.
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"
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.
To edit a sub-category click on the sub-category you would like to edit and then click on the "edit this category" link.
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.
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.
Groups can be assigned to categories/sub-categories under the create group section of the Affiliate Center.
Categories/sub-categories can also be applied in the Affiliate Center on any media, member or group details page.
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.
Categories in Feed Builder
You can also create RSS feeds, using the feed builder interface, which filter the results based on categories.
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
Favorites









