You can use content labels to organize your content, build content lists, and create maps and calendars targeted toward specific pages. Content labels are for internal use only, so your site visitors will not see them. They differ from category tags, like those used for events or parks, as they are invisible to your community and cannot be used to search for content.
Before adding content labels to your pages, you should determine how to use them. Ask yourself which feature of OpenCities you wish to use that requires content labels, what labeling convention you will use, and how you will document which labels must go on which pages. Here are the common use cases:
- Content lists
- Related content
- Create layers on maps to indicate locations
- Using combined calendars to distinguish different types of meetings or events
There are two ways to add content labels: through the site admin or the Supporting information on a page. But firstly, here are a few tips for using and organizing your content labels:
- Content labels can only be one word, with no spaces. You should use the same naming convention for all of them when adding content labels. For example, you may want to use camel case (ContentLabel) or hyphens to separate words (content-label). How you name your labels is up to you, but using a universal naming convention can help you keep your list of content labels organized and make it easier to add them.
- Additionally, all your sites will draw from the same list of content labels, so you may also want to specify on your content labels if they're for a specific site. For example, you could use "theater-festivals" for a theater subsite.
- We recommend documenting your content labels and their uses to track which pages need specific labels. For example, if you're setting up a content list of venues for a particular purpose, you should note which label is used on the OC Venue pages so that if you need to add another venue, you'll know which label it needs.
Add Content Labels to the Site Admin
This task is for users with the OC System Administrator role.
The best way to create your list of content labels is through the site admin. Creating them this way allows you to create many labels simultaneously and ensure you're not doubling up on labels. Here's how to do it:
- Go to More > Content Labels. You'll see a text field to add labels and a list of current content labels.
- To add content labels, type them into the text field and select Add. You can use the following characters: the letters A-Z, numbers from 0-9, hyphens (-), and underscores (_).
- To add several labels at once, separate your labels with a space or a comma.
- Once you've added all the labels you need, select Save. Once you've saved, the list will organize itself alphabetically.
You'll notice that each label in the list has a number in brackets attached to it. This number refers to how many pages the label is being used on. Selecting this number will show you the list of pages linked to the label and its Name, the Site it belongs to, and the page's Status, Owner, and Author. Selecting a page from the list will take you directly to the page's admin.
System administrators and Site Managers can also create labels directly on a page:
- Open the expandable Supporting information menu in the Overview tab when creating or editing a page.
- In the Content labels field, start typing in the label you need. If there is no matching label, finish typing it and hit enter to add it to the page and the content labels list. To add more than one label, separate each one with a space.
- Save or Publish the page.
Content authors without the OC Site Manager or OC System Administrator role can add labels to pages but cannot create them. To give them this permission, you need to create a new role for them.
Attach Content Labels to a Page or File
Content authors can attach content labels to pages and files as long as they already exist in your content labels list. You can add labels to any page with a Supporting information field.
- With the page or file in work-in-progress mode (WIP), open the Supporting information menu in the Overview tab.
- Start typing the label you need in the Content labels field and select it from the list.
- If you add a label you don't need, select the x on the label to remove it.
- Save or Publish your page or file.