DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: Backend news¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed: | 2007-01-10T08:52:14 |
Author: | HO Thi Ngoc Tu |
Email: | thi-ngoc-tu.ho@vd.ch |
Info 3: | |
Info 4: |
EXT: Backend news¶
Extension Key: vd_backendnews
Copyright 2006, HO Thi Ngoc Tu, <thi-ngoc-tu.ho@vd.ch>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.com
Table of Contents¶
EXT: Backend news 1
Introduction 1
What does it do? 1
Screenshots 2
User manual 2
Standard editor screen 2
Super editor screen 2
Administration 4
Create a storage folder 4
Configure users and groups 5
Configure the extension 6
Configuration 7
Reference 7
FAQ 7
Tutorial 7
To-Do list 7
Changelog 7
Linking 7
Introduction¶
What does it do?¶
This sub-module of the taskcenter allows to write and publish internal news for Typo3 editors.
This news can be searched by categories or dates. An edito allows to emphasize an special category of news.
Screenshots¶
Please have a look directly in the User manual.
User manual¶
Standard editor view¶
The standard editor is the backend user which we want to communicate some news.
Here is the standard editor view.
News list¶
a
News list
News are displayed here according to search criteria. Each news post has a title, a category and a publishing date.
b
Search form
Category or date search
Super editor view¶
The super editor is the backend user who is allows to add, edit and delete news posts.
Add news view¶
- Title: News title (HTML allowed)
- Text: You are allowed to write HTML code if you want a special display.
- Category: News category to organize news and refine news search.Categories are defined in the Manage category menu.**Editorial** category is a special one: all news of this type will be displayed below the search form, in the edito part.
- Publication date: Set the date when you want your post to be visible by standard editors. Only super editors can see all news.
Manage category view¶
- New category: create a new category.
- Category modification: choose the existing category in the dropdown menu, write its new name in the input text on the right and click on Update.
- Category deletion: to delete a category, no news must be attached to it. You need first to delete all news from the aimed category (or change their assigned category).
Administration¶
Once you have downloaded and installed this extension with the Extension Manager (EM: in the backend Tools > Ext Manager), you need to go through the following steps in order to make the plugin ready to use for the users.
Create a storage folder¶
Create a new page somewhere in your webtree.
Set the page type to SysFolder and give a meaningful name to it (News&categories for ex.)
Do remember the ID of this new page (in our example, it's 8373).
Configure users and groups¶
To grant super editor privileges to a standard editor, follow the steps:
Create a new backend usergroup.
Fill up the form with the following instructions:
Set a grouptitle: Backend news (or whatever group name you want)
Select the 'Include Access list' checkbox, this will edit the form and allow you to configure more necessary settings:
Tables (listing): select
- Taskcenter news categories
- Taskcenter news posts
Tables (modify): select
- Taskcenter news categories
- Taskcenter news posts
Allowed exclude fields: select
- Taskcenter news categories: Category name
- Taskcenter news posts: News title
- Taskcenter news posts: Publication time
- Taskcenter news posts: Text
- Taskcenter news posts: Category
Select the system folder you have previously created in DB Mounts:
Add this line to TSconfig text area:VD_BACKENDNEWS.edit = 1VD_BACKENDNEWS.pid = [uid of system folder]
Save the whole form and add this new group to the users that will have the privilege to edit the backend news.
Change the system folder permissions for the group in Access > [your system folder] > Change permissions to: Show page [x], Edit content [x], Edit page [ ], Delete page [ ], New pages [ ] (in the Group line).
You can do a little check by switching to one of the backend news editors, and go to the Taskcenter: if everything is well configured, you will see an extended menu that allows you to edit news and categories.
Configure the extension¶
Besides the mandatory TSconfig settings in the backend usergroup, you can add the following optional configuration for a usergroup that contains ALL your users.
But if you want to do some fine tuning, you may also configure this group by group or even at the user level, as there is
VD_BACKENDNEWS.specialCategory = <uid of the special category>This setting is useful if you want to change the news that go to the right of the Taskcenter > Backend news panel.By default, the first created category will be assigned as the special category (it will be surrounded with stars in the different places where it appears in the edit forms). In our example, we have called it 'Editorial'.
VD_BACKENDNEWS.nbrSearchDays = 14This setting allows you to define the number of days in the past the search should do to retrieve the news. The 'Date from' text input field will hold the default value : today - nbr_search_days, and the news listed on the main part of the Backend news overview panel satisfy this search criteria.
VD_BACKENDNEWS.nbrItemsPerPage = 3This setting controls the number of news displayed per page in the Backend news overview panel. If there are more than the number set, a page numbering will appear and let the user browse through all searched news.
Configuration¶
Reference¶
Here's the complete reference of the user or usergroup TSconfig for this module.
edit¶
Property
edit
Data type
int
Description
1 if you want the user(group) to have the right to manage news and news categories.
Default
0
pid¶
Property
pid
Data type
int
Description
Uid of the system folder that contains the news and their category.
Default
0
specialCategory¶
Property
specialCategory
Data type
int
Description
Uid of the special news category whose news are displayed on the right of the main news panel.
Default
1
nbrSearchDays¶
Property
nbrSearchDays
Data type
int
Description
Default number of days in the past for news searching.
Default
14
nbrItemsPerPage¶
Property
nbrItemsPerPage
Data type
int
Description
Default number of news to display in one search result page.
Default
3
FAQ¶
Why can we not delete all categories?Because only categories which have no news associated yet can be deleted.
Tutorial¶
See User Manual in the present document.
To-Do list¶
- Some refactoring will not harm
Changelog¶
Version 0.1.0: first public release.
Linking¶
This extension is used in the backend of the website : http://www.vd.ch
EXT: Backend news - 7