2. Rubrics (List View)

The view “Rubrics” lists all rubrics. Here you can choose the rubrics the administrator has given you access rights for. To call up this view, click on the option “List rubrics” in the menu “Rubrics”. The “Rubrics” list view also is the welcome page you will see after you have logged in to the ConPresso backend.

In the ConPresso backend you navigate via the menus and options that you can see in the ConPresso navigation bar on the left side of your browser window. The frontend of your ConPresso project probably also has a navigation that visitors can use to navigate through the project. If you want the backend to reflect this navigation structure, the administrator has to create it in the backend first. The content and structure of the “Rubrics” list view depends on if and how much of the navigation was created in the backend. The following constellations are possible:

  1. The administrator has not created the navigation structure yet.

    In that case, all rubrics are listed in a table in alphabetical order. If the administrator has defined the number of rubrics displayed on one page (e.g. 10) a page break is inserted and the following rubrics are listed on the next page. If your project contains a large number of rubrics, you will therefore have to navigate through the rubrics by using the links below the last rubric entry on each page.

  2. The administrator has created the navigation structure but has not embedded all rubrics in it (yet).

    In that case, the “Rubrics” list view will contain two tables, one above the other. The first table will show the rubrics that are embedded in the frontend's navigation structure. The first column of this table is entitled “Navigation” and it reflects the navigation structure of the project. Just like described in case A, the second table shows the rubrics not embedded in the navigation structure.

  3. The administrator has created the navigation structure and all rubrics are embedded in that structure.

    In that case, the second table described in B is omitted. There is only one table and its first column reflects the frontend's navigation structure.

Navigation

The column entitled “Navigation” contains the elements of the navigation structure of the frontend of your ConPresso project. For information on how to create this navigation structure in the backend please refer to Section 5, “Edit Navigation”.

This symbol is displayed if this element of the navigation structure contains sub-elements. Click on the element to show its sub-elements.

This symbol is displayed if you have clicked on the element to show its sub-elements. To hide the sub-elements click on the higher-ranking element.

This symbol is displayed if the element does not have any sub-elements.

Rubric/URL

The column “Rubric/URL”contains the entry “[URL]” if external links were embedded via the navigation. The tooltip displays the address the element links to. Only users with the roles of "Superuser" or "Administrator" can add or edit external links as described in Section 5, “Edit Navigation” therefore a user with the role of an "Editor" cannot select that entry.

In most cases the name of the rubric will be displayed in that column. You can select a rubric by clicking on its name. Then the list view “Edit articles” will be displayed. For more information on that view please refer to Section 2, “Edit Articles (List View)”.

Manage

The column “Manage” can be seen by users with the roles of "Administrator" or "Superuser" exclusively. It contains the following buttons:

Click on this button to call up the view described in Section 2.1, “Edit Rubric Settings”.

Click on this button to call up the view described in Section 2.5, “Edit Rubric Rights”.

Click on this button if you want to delete a rubric. For some important information on this process please refer to Section 2.6, “Delete Rubric”.

Published

The column “Published” displays the number of articles that are published so that they can currently be seen on the rubric output-page in frontend of the ConPresso project. An article is "published" only if an authorized user has approved it and if it has reached its publication period at the current point of time. For further information please refer to Section 2, “Edit Articles (List View)”.

Total

The column “Total” displays the total number of articles contained in this rubric.

Info

The column “Info” displays further information about this rubric, if available. This column may, for instance, contain a symbol signifying the rubric type.

This symbol signifies that this rubric is a restricted rubric.

This symbol signifies that this rubric is a personalized rubric.

Rubrics not in navigation

This column displays all those rubrics that have not been allocated to elements of the frontend's navigation structure yet. These rubrics are listed alphabetically. Select a rubric by clicking on its name. For further information on the view that is displayed subsequently please refer to Section 2, “Edit Articles (List View)”.

[Tip]Tip

For the quick selection of a rubric please use the dropdown menu in the title bar as described in Section 4.1, “The ConPresso Title Bar”.

2.1. Edit Rubric Settings

Users with the roles of "Administrator" or "Superuser" define the settings of a rubric while they create it and they can edit them afterwards. To edit the settings of a rubric, please call up the list view “Rubrics” and click on the button “Edit rubric settings” that is in the row of the rubric and the column “Manage”. The ConPresso workspace will then display the view “Edit rubric settings”.

Rubric settings primarily serve the purpose of defining the output of a rubric. The settings of a rubric are devided into three sections that are explained in Section 2.2, “Edit Basic Rubric Settings”, Section 2.3, “Source for Extended Rubric Settings” and Section 2.4, “Extended Rubric Settings”. The extended rubric settings that are displayed depend on the settings defined in the relevant section entitled “Source for extended rubric settings ”.

2.2. Edit Basic Rubric Settings

The basic rubric settings make creating and outputting an article possible. Therefore it is absolutely necessary to define them. Basic rubric settings contain information that is unique to each individual rubric, they can not be applied to other rubrics as described in Section 2.4, “Extended Rubric Settings”.

The basic rubric settings “Rubric name”, “Rubric title” and “Rubric type” have to be entered for each rubric individually. In addition to that, this section contains the “Rubric ID” and the URLs you need to “Include rubrics”. Use “Deactivate rubric” is you want a rubric to appear offline.

Rubric ID

This is the ID of the rubric. Each rubric ID is unique and it is generated automatically when you create a rubric. You cannot change the rubric ID.

Include Rubrics

When you are adapting your ConPresso project you will need information about how you can call up its contents.

As a rule you can call up ConPresso rubrics by clicking on a link or by entering the relevant URL into your browser. This link or address is composed as follows:

  • http://www.example.com/conpresso/rubricdirectory/index.php?rubric=Rubricname or

  • http://www.example.com/conpresso/rubricdirectory/index.php?rubric=Rubric-ID

Example 7.1. Calling Up a ConPresso Rubric

You have installed ConPresso in the subdirectory conpresso of your webserver's root directory and you want to call up the rubric "News" from the the default rubric directory _rubric.

In that case you can open this rubric by entering the following address into your browser:

  • http://www.example.com/conpresso/_rubric/index.php?rubric=News


When you customize ConPresso as described in Chapter 15, Customize ConPresso you can copy & paste these URLs and insert them into your source code as links if you want to.

If you would like to provide contents of your ConPresso project on an external website that may even be located on another webserver, you can use the PHP or Javascript variants of this URL. You can use the generated links in any PHP or HTML page. Thus you can include contents of your ConPresso project in any website.

Include rubrics

PHP variant

In order to provide the contents of a ConPresso rubric on an external webpage that allows PHP, please use the “PHP variant”. Copy the “PHP variant” and paste it into the source code of the external webpage. Now, if you call up that webpage, it will display the content of that ConPresso rubric.

Javascript variant

As an alternative to the PHP variant you can use the “Javascript variant” to provide the contents of a ConPresso rubric on an external webpage. Use this variant of the external website does not allow PHP code. To include this rubric copy the “Javascript-variant” and paste it into the source code of the external webpage.

If you choose the Javascript variant, please be aware that Javascript needs to be activated in the browsers of those visiting that external webpage - otherwise they will not be able view its contents.

[Note]Note

Please note that for this particular form of output, that is the inclusion of rubrics, you have to define a special section in the article-template. For further information please refer to Section 3, “Edit Article-Templates (List View)”.

[Tip]Tip

By using the PHP or Javascript variant you can also publish more than one ConPresso rubric on a webpage. Just insert the relevant source code into the header/footer of another rubric.

Rubric name

Please enter a name for that rubric. This name will be used within the ConPresso backend where it will be listed in the view “Rubrics” for instance. In the frontend, the rubric name will not be displayed on the rubric page, however, it might be part of the URL that is used to call up the rubric.

Please try to choose a rather self-explanatory rubric name so that editors can easily identify the rubric they want to work with.

Rubric title

Please enter the rubric title. The rubric title can be displayed on the rubric page in the frontend, for instance above the first article.

Rubric directory

Please choose the rubric directory that you want to use for the rubric output. The dropdown menu contains all the rubric directories available in your installation of ConPresso. If you want to create more rubric directories you have to add them via an FTP client.

By choosing the “Rubric directory” you determine what the rubric will look like. For further information on rubric directories please refer to Chapter 15, Customize ConPresso.

Rubric type

Please choose one of the entries explained below as the type of your rubric. For more information please refer to Chapter 16, Restricted Sections and Personalization.

public rubric

Public rubrics are rubrics that can be viewed by anyone visiting the frontend of your project. Visitors do not have to enter a password first and they can view all articles published in this rubric.

personalized rubric

The contents of personalized rubrics are only visible to certain users or user groups. Editors can specify an article as personalized for certain user groups when they create or edit articles. In other words, if you choose the rubric type “personalized rubric” you only provide the opportunity for editors to specify an article as personalized.

To view personalized articles the visitor of your project has to log in first.

If the visitor does not log in, only the public articles of the rubric will be displayed and the personalized ones will remain invisible. Thus, a personalized rubric can contain articles that can be viewed by all visitors of your project, depending on the settings defined by the editor.

restricted rubric

The frontend page of rubrics of the type “ restricted rubric” can only be viewed after a login. If a visitor tries to call up a restricted rubric, ConPresso will request his or her username and password before it displays the contents of the rubric.

This setting thus provides a general access limitation. If you want to give certain user groups access to this rubric, please use the next setting entitled “Group access” after you have set the rubric type to “closed rubric” and have saved that setting.

Group access

If you have set the rubric type to “closed rubric”, all user groups that have been defined so far will be listed here and you can tick the to give them access to that rubric in the frontend. The user groups have to be defined before they can appear here, for more information on this procedure please refer to Chapter 12, Users.

[Note]Note

For more information on the topics "personalization" and "restricted user areas" please read Chapter 16, Restricted Sections and Personalization.

Deactivate rubric

Use the option “Deactivate rubric” if you want a rubric to appear offline. If you deactivate a rubric, visitors of your project cannot see its contents anymore. Instead of the rubric page they will see the message you have entered in the following field.

[Tip]Tip

This function comes in handy if you want to create all the contents of a rubric first and publish it when it is complete.

To save the settings of this rubric, please click on the button “Save” or “Save and return to list of rubrics ”.

2.3. Source for Extended Rubric Settings

Other than the "Basic rubric settings", the settings of the section entitled "Extended rubric settings" can be applied to more than one rubric. Most of the settings specified here are relevant for the appearance of a rubric as well as for the way it functions.

Source

Use the dropdown menu entitled “Source” to specify if the rubric should use its own “individual extended settings” or if it should use the extended settings of an existing rubric.

Individual settings

Please choose the entry “individual settings” from the dropdown menu and click on the button “Save”, if you want this rubric to apply individual extended settings. You can specify these settings in the following section entitled “Extended rubric settings”.

The entry “individual settings” is the default setting of this dropdown menu when you create a new rubric.

Extended settings of an existing rubric

If you want to apply the settings of an existing rubric to this rubric, please choose that rubric from the dropdown menu “Source” and click on the button “Save”.

The extended settings of the rubric you have chosen will be applied to the present rubric. Thus, it is not necessary to specify further settings and the section “Extended rubric settings” is hidden.

2.4. Extended Rubric Settings

By specifying the extended rubric settings you can influence the appearance of the rubric page in the frontend.

Other than the basic rubric settings the extended settings can be applied to more than one rubric. If that is the case, the rubrics applying those extended settings will be listed under "Source for extended rubric settings". Therefore please be aware that changes applied to the extended settings of a rubric may influence other rubrics as well.

Message if no article is found

You can enter a message that will be displayed if no articles are published in that rubric into the field “ Message if no article is found ”.

Example 7.2. “Message if no article is found

You are using ConPresso to advertise job vacancies on your website. However, currently there are no jobs available. In that case a message like "Sorry, no jobs available at the moment!" will be shown, if you have entered that message into the field “ Message if no article is found ” in the extended rubric settings of the rubric "Jobs".


No. of articles on rubric page

By entering a number into the field “No. of articles on rubric page” you define the number of articles that will be shown on the rubric page in the frontend of your ConPresso project. If the number of articles published in that rubric exceeds that number, a new page will be created automatically where the other articles can be seen.

Example 7.3. “No. of articles on rubric page

For a rubric containing 7 articles, you have defined the number 3. At the bottom of the rubric page in the frontend you will find a link (e.g. "next page") leading to the next page. On that page you will find a link to the next as well as to the previous page (e.g. "next page"). You can specify the link text in the extended rubric settings.


Article sorting

Use the options of “ Article Sorting ” to define how the articles of that rubric are organized.

ConPresso can sort articles by creation date beginning either with the most recent or the eldest article so that they will appear in that order on the rubric page of your project.

Sort by index, date (most recent article first)

Choose this option if you want the most recent articles to appear first on the rubric page. The latest article will be shown on top of the page. The creation date is significant for this sortation. If you want to enable editors to influence the position of individual articles, they have to be allowed to edit the article index (see option “Allow editing of fields”).

Sort by index, date (oldest article first)

Choose this option if you want place recent articles at the end of a rubric page.

Manually

Choose the option “ Manually ” if you want to activate the manual sorting of articles for this rubric. Editors will then be able to sort articles themselves by using the up- and down-buttons in the view “Edit article”.

For manual sorting ConPresso uses the article index, that can be changed directly when the article is edited (see option “Allow editing of fields”).

Allow editing of fields

ConPresso automatically generates the content of the some fields, for example those related to the user account, when an article is created. Check the relevant boxes in the section entitled “Allow editing of fields” to allow the editors to change them.

Index

Check this box to enable an editor to change the entry automatically generated in the field “Index” when he or she is creating or editing an article. The index of an article is relevant for sorting the articles of a rubric (see also “ Article sorting”. If this box remains unchecked, the index is hidden from editors as its content usually is not relevant for the process of creating or editing an article.

Initials

Check this box to enable an editor to change the entry automatically generated in the field “Initials” when he or she is creating or editing an article.

Author

Check this box to enable an editor to change the entry automatically generated in the field “Author” when he or she is creating or editing an article.

eMail

Check this box to enable an editor to change the entry automatically generated in the field “eMail” when he or she is creating or editing an article.

Article-templates

In the section entitled “Article-templates” you can specify which article-templates are allowed in this rubric as well as the default article-template of this rubric. The names of all article-templates created in this ConPresso project so far are listed in this section. Please use the checkboxes and radio buttons to specify your choice.

The default article-template will be set by default when an editor creates an article, therefore you should choose the most frequently used article-template.

Create and name article-templates as you like. For more information on how to create article-templates please refer to Chapter 11, Templates.

Rubric language

Here you can specify the language of the rubric. This language will be used for instance when the content of the date field is displayed.

Date format

Here you can specify the date format. For further information please refer to Appendix A, PHP Date Formatting.

Article separation code

Use this field to generate a separation code between articles. This can be a horizontal rule <HR>, for instance, but any other HTML code will work as well.

Page navigation linktext

If the number of articles published in a rubric exceeds the number defined in the field “ No. of articles on rubric page ”, ConPresso will provide links that enable visitors of your project to navigate through the articles of that rubric.

Previous page

Please enter the text linking to the previous page.

Next page

Please enter the text linking to the next page.

Show additional information

Please check the box “ Show additional information ” to add the information “Found:” and “Results” to the navigation.

Found

Please enter the text that you want to appear instead of "Found:"

Results

Please enter the text that you want to appear instead of "Results:"

[Note]Note

If fields are without entries their names will we used by default.

Activate archive

If the publication period of an article has run out, it will not be deleted but archived in the database. Activate this function by checking the box and give users access to that archive (for instance to earlier press releases).

You can enter your own text linking to the archive into the field “Generate link to archived (expired) articles, use the following link text”.

For a rubric like "Press" the link texts might be "Show press release archive", "Earlier press releases", "More press releases" or the like.

When you have completed the settings click on the button “ Save settings ” or on “Save settings & return to list of rubrics”.

2.5. Edit Rubric Rights

In order to edit a user's (e.g. an editor's) access rights for a specific rubric, please call up the list view “Rubrics” and click on the button "Edit rubric rights" in the column “Manage” and the row of the rubric. This opens the view “Edit rubric rights”.

A red access right symbol indicates that the right has been given and can be withdrawn by clicking on it. A green access right symbol indicates that the right has not been given yet and that this can be done by clicking on it.

User

The column “User” lists the names of all users registered in ConPresso.

Active

This button indicates that the user does not have the access rights for this rubric. Click on this button to assign them to the user.

This button indicates that the user has the access rights for this rubric. Click on this button to withdraw them.

Create

This button indicates that the user does not have the right to create new articles in this rubric. Click on this button to assign this right to the user.

This button indicates that the user already has the right to create new articles in this rubric. Click on this button to withdraw this right.

Manage

This button indicates that the user does not have the right to manage existing articles of this rubric. Click on this button to assign this right to the user.

This button indicates that the user already has the right to edit existing articles of this rubric. Click on this button to withdraw this right.

Upload

This button indicates that the user does not have the right to upload files and images for the use in articles of this rubric. Click on this button to assign this right to the user.

This button indicates that the user has the right to upload files and images for the use in articles of this rubric. Click on this button to withdraw this right.

Approval

This button indicates that the user does not have the right to approve, block or reject articles of this rubric. Click on this button to assign this right to the user.

This button indicates that the user has the right to approve, block or reject articles of this rubric. Click on this button to withdraw this right.

Global

By clicking on this button you can withdraw all rubric rights given to the user at once.

By clicking on this button you can assign all rubric rights to the user at once.

[Note]Note

If you proceed as described in Section 3.2, “Edit User Rights” , you can also define the rights of one specific user in relation to all existing rubrics.

2.6. Delete Rubric

In order to delete a rubric please click on “List rubrics” in the menu “Rubrics”. This will open the list view “Rubrics” where you will find the button “Delete rubric” in the column “Manage” and the row of the rubric. Click on this button and confirm the deletion when prompted. Only users with the roles of "Administrator" or "Superuser" can delete rubrics.

[Caution]Caution

If you delete a rubric you will also delete all articles contained in this rubric.

You cannot undo the deletion of a rubric.

[Note]Note

If the deleted rubric was based on a specific rubric directory that is not used and will not be used by another rubric you can use an FTP client to delete this directory.