tonyair/silverstripe-framework
1
0
Fork 0
mirror of https://github.com/silverstripe/silverstripe-framework synced 2024-10-22 14:05:37 +02:00
Code Issues Projects Releases Wiki Activity

Fixed inconsistencies and out of date information

Browse Source
This commit is contained in:
Jordan Koncz 2014-03-14 20:49:26 +11:00
parent eca35c473c
commit faf36ba713
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/en/tutorials/2-extending-a-basic-site.md
View File

@ -200,10 +200,12 @@ the date field will have the date format defined by your locale.
public function getCMSFields() { public function getCMSFields() {
$fields = parent::getCMSFields(); $fields = parent::getCMSFields();
$fields->addFieldToTab('Root.Main', $dateField = new DateField('Date','Article Date (for example: 20/12/2010)'), 'Content'); $dateField = new DateField('Date', 'Article Date (for example: 20/12/2010)');
$dateField->setConfig('showcalendar', true); $dateField->setConfig('showcalendar', true);
$dateField->setConfig('dateformat', 'dd/MM/YYYY');
$fields->addFieldToTab('Root.Main', $dateField, 'Content'); $fields->addFieldToTab('Root.Main', $dateField, 'Content');
$fields->addFieldToTab('Root.Main', new TextField('Author'), 'Content'); $fields->addFieldToTab('Root.Main', new TextField('Author', 'Author Name'), 'Content');
return $fields; return $fields;
} }
@ -211,7 +213,7 @@ the date field will have the date format defined by your locale.
Let's walk through these changes. Let's walk through these changes.
:::php :::php
$fields->addFieldToTab('Root.Main', $dateField = new DateField('Date','Article Date (for example: 20/12/2010)'), 'Content'); $dateField = new DateField('Date', 'Article Date (for example: 20/12/2010)');
*$dateField* is declared in order to change the configuration of the DateField. *$dateField* is declared in order to change the configuration of the DateField.
@ -226,7 +228,7 @@ By enabling *showCalendar* you show a calendar overlay when clicking on the fiel
*dateFormat* allows you to specify how you wish the date to be entered and displayed in the CMS field. See the `[api:DateField]` documentation for more configuration options. *dateFormat* allows you to specify how you wish the date to be entered and displayed in the CMS field. See the `[api:DateField]` documentation for more configuration options.
:::php :::php
$fields->addFieldToTab('Root.Main', new TextField('Author','Author Name'), 'Content'); $fields->addFieldToTab('Root.Main', new TextField('Author', 'Author Name'), 'Content');
By default the field name *'Date'* or *'Author'* is shown as the title, however this might not be that helpful so to change the title, add the new title as the second argument. By default the field name *'Date'* or *'Author'* is shown as the title, however this might not be that helpful so to change the title, add the new title as the second argument.
@ -335,19 +337,23 @@ Now let's make a purely cosmetic change that nevertheless helps to make the info
Add the following field to the *ArticleHolder* and *ArticlePage* classes: Add the following field to the *ArticleHolder* and *ArticlePage* classes:
:::php :::php
private static $icon = "framework/docs/en/tutorials/_images/treeicons/news-file.gif"; private static $icon = "cms/images/treeicons/news-file.gif";
And this one to the *HomePage* class: And this one to the *HomePage* class:
:::php :::php
private static $icon = "framework/docs/en/tutorials/_images/treeicons/home-file.gif"; private static $icon = "cms/images/treeicons/home-file.png";
This will change the icons for the pages in the CMS. This will change the icons for the pages in the CMS.
![](_images/tutorial2_icons2.jpg) ![](_images/tutorial2_icons2.jpg)
<div class="hint" markdown="1">
Note: The `news-file` icon may not exist in a default SilverStripe install. Try adding your own image, or choosing a different one from the `tree-icons` collection.
</div>
## Showing the latest news on the homepage ## Showing the latest news on the homepage
It would be nice to greet page visitors with a summary of the latest news when they visit the homepage. This requires a little more code though - the news articles are not direct children of the homepage, so we can't use the *Children* control. We can get the data for news articles by implementing our own function in *HomePage_Controller*. It would be nice to greet page visitors with a summary of the latest news when they visit the homepage. This requires a little more code though - the news articles are not direct children of the homepage, so we can't use the *Children* control. We can get the data for news articles by implementing our own function in *HomePage_Controller*.