Category Options
General
| option | description |
| Category Name | Specify the name of the category. |
| Parent Category | If you're planning on making this category a subcategory, select which category is it's parent. Otherwise, if this category is going to be a parent category you'll want to select "None (top level category)". |
| Hide Category |
Hidden Categories and their article summaries are
not listed in any indexes or headline includes, other
than the headline and index files for that category.
Articles are still published, as well as any other
files specific to that category.
"Hide Category" will only hide that specific category, not any subcategories under it. Articles in hidden categories are not syndicated into the webfeed generator. |
| Display Only | With this checked this category will be designated as display only, meaning users can't add articles to it. A display only category is useful if you want a Top Level parent category where article's can't be added to it but can still output articles from it's subcategories. |
Advanced Options
Category Settings
| option | description |
| Articles per page | From here you can define for this category how many articles you would like to output per page. Selecting "Default", will use the default settings as defined in the Setup Options -> Server Options. Selecting "Custom" allows you to overwrite the default settings and set a unique per page value for the category you're creating/updating. |
| Category Filename |
From here you can define for this category a unique category filename. Selecting "Default", will use the default naming convention as defined in the Setup Options -> Server Options. Selecting "Custom" allows you to overwrite the default settings and have this category published using a unique filename.
As of version 1.30, Custom category filenames are checked for conflict against articles and global files. |
| Category Images |
Category images are used to create a visual association
to which category an article belongs. For example, sports
articles might all have a small basketball beside their titles.
Category images are only included by default in the dusk template set. To add them to any of the other template sets or to your custom templates, add the $cat_image$ placeholder to your article index templates. Articles in hidden categories are not syndicated into the webfeed generator. |
Templates
In this section, you can specify which templates are used for both the category and the category's articles.
To make new options available in category template pulldowns, you must place the template in the appropriate folder:
| Category Index Page | templates/index/ |
| Latest Headlines | templates/headlines/ |
| Article Pages | templates/article/ |
| Article Printer Pages | templates/article/ |
This section allows you to customize the upload and publish folders for the category. When Setup Defaults are chosen, article and printer files will be published to the publish directory shown in Server Options. If you choose the Custom option you will be required to specify publish and upload directories.
Changing these settings for an existing category will move article and uploaded files to the new location.
Setting Compatible SSIs
If you are publishing articles to a directory other than your main
"publish" folder, all SSIs in the article templates should be "virtual"
includes rather than "file" includes so that they will work
regardless of the location of the article, i.e.:
<--#include virtual="/includes/file.html"--> (unix)
<--#exec cgi="/includes/file.html"--> (windows)
For Article Manager published includes (like headline files) your SSI code should use the $publishdir_virtual$ placeholder to automatically set the virtual path to the publish directory. Your includes should look something like this:
<--#include virtual="$publishdir_virtual$$file_*$"--> (unix)
<--#exec cgi="$publishdir_virtual$$file_*$"--> (windows)
$publishdir_virtual$
The directory path from your site's URL root to Article
Manager's publish folder, i.e. /artman/publish/
$file_*$
Many placeholders publish the filename of one of Article Manager's
includes ($file_categories$, $file_search$, $file_headlines_bycat$,
$file_headlines$, $file_gcategories$, and $file_gheadlines$).