mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-06-25 22:19:33 +02:00
cc712892a9
* MINOR: Add `Previous`, `Next` and `Create New` actions in edit form If the form is opened via a grid field, the filters will be retained so the previous/next record opened will be correct * MINOR: Add ability to customise the visibility of the `Previous`, `Next` and `Add` buttons at a `GridField` level * Fix invalid action when pressing the `New` button in an edit form unless `betterbuttons` module was installed * - Merge `showPrevious` and `showNext` to `showPagination` for grid fields - Update documentation - Improve performance for next/previous buttons by not fetching all list records - Refactoring * Refactor to fail gracefully on GridFieldPaginator
151 lines
4.3 KiB
Markdown
151 lines
4.3 KiB
Markdown
# How to customise the CMS Menu
|
|
|
|
## Adding an administration panel
|
|
|
|
Every time you add a new extension of the [LeftAndMain](api:SilverStripe\Admin\LeftAndMain) class to the CMS,
|
|
SilverStripe will automatically create a new [CMSMenuItem](api:SilverStripe\Admin\CMSMenuItem) for it
|
|
|
|
The most popular extension of LeftAndMain is a [ModelAdmin](api:SilverStripe\Admin\ModelAdmin) class, so
|
|
for a more detailed introduction to creating new `ModelAdmin` interfaces, read
|
|
the [ModelAdmin reference](../modeladmin).
|
|
|
|
In this document we'll take the `ProductAdmin` class used in the
|
|
[ModelAdmin reference](../modeladmin#setup) and so how we can change
|
|
the menu behaviour by using the `$menu_title` and `$menu_icon` statics to
|
|
provide a custom title and icon.
|
|
|
|
### Defining a Custom Icon
|
|
|
|
First we'll need a custom icon. For this purpose SilverStripe uses 16x16
|
|
black-and-transparent PNG graphics. In this case we'll place the icon in
|
|
`app/images`, but you are free to use any location.
|
|
|
|
|
|
```php
|
|
use SilverStripe\Admin\ModelAdmin;
|
|
|
|
class ProductAdmin extends ModelAdmin
|
|
{
|
|
// ...
|
|
private static $menu_icon = 'app/images/product-icon.png';
|
|
}
|
|
```
|
|
|
|
### Defining a Custom Title
|
|
|
|
The title of menu entries is configured through the `$menu_title` static.
|
|
If its not defined, the CMS falls back to using the class name of the
|
|
controller, removing the "Admin" bit at the end.
|
|
|
|
|
|
```php
|
|
use SilverStripe\Admin\ModelAdmin;
|
|
|
|
class ProductAdmin extends ModelAdmin
|
|
{
|
|
// ...
|
|
private static $menu_title = 'My Custom Admin';
|
|
}
|
|
```
|
|
|
|
In order to localize the menu title in different languages, use the
|
|
`<classname>.MENUTITLE` entity name, which is automatically created when running
|
|
the i18n text collection.
|
|
|
|
For more information on language and translations, please refer to the
|
|
[i18n](/developer_guides/i18n) docs.
|
|
|
|
## Adding an external link to the menu
|
|
|
|
On top of your administration windows, the menu can also have external links
|
|
(e.g. to external reference). In this example, we're going to add a link to
|
|
Google to the menu.
|
|
|
|
First, we need to define a [LeftAndMainExtension](api:SilverStripe\Admin\LeftAndMainExtension) which will contain our
|
|
button configuration.
|
|
|
|
|
|
```php
|
|
use SilverStripe\Admin\CMSMenu;
|
|
use SilverStripe\Admin\LeftAndMainExtension;
|
|
|
|
class CustomLeftAndMain extends LeftAndMainExtension
|
|
{
|
|
|
|
public function init()
|
|
{
|
|
// unique identifier for this item. Will have an ID of Menu-$ID
|
|
$id = 'LinkToGoogle';
|
|
|
|
// your 'nice' title
|
|
$title = 'Google';
|
|
|
|
// the link you want to item to go to
|
|
$link = 'http://google.com';
|
|
|
|
// priority controls the ordering of the link in the stack. The
|
|
// lower the number, the lower in the list
|
|
$priority = -2;
|
|
|
|
// Add your own attributes onto the link. In our case, we want to
|
|
// open the link in a new window (not the original)
|
|
$attributes = [
|
|
'target' => '_blank'
|
|
];
|
|
|
|
CMSMenu::add_link($id, $title, $link, $priority, $attributes);
|
|
}
|
|
}
|
|
```
|
|
|
|
To have the link appear, make sure you add the extension to the `LeftAndMain`
|
|
class. For more information about configuring extensions see the
|
|
[extensions reference](/developer_guides/extending/extensions).
|
|
|
|
|
|
```php
|
|
LeftAndMain::add_extension('CustomLeftAndMain')
|
|
```
|
|
|
|
## Customising the CMS help menu
|
|
|
|
The CMS help menu links in the south toolbar are configurable via your [configuration file](../../configuration).
|
|
You can edit, add or remove existing links as shown in the examples below:
|
|
|
|
```yml
|
|
# app/_config/config.yml
|
|
SilverStripe\Admin\LeftAndMain:
|
|
help_links:
|
|
# Edit an existing link
|
|
'CMS User help': 'https://example.com'
|
|
# Add a new link
|
|
'Additional link': 'https://example.org'
|
|
# Remove an existing link
|
|
'Feedback': ''
|
|
```
|
|
|
|
## Customising the CMS form actions
|
|
|
|
The `Previous`, `Next` and `Add` actions on the edit form are visible by default but can be hidden globally by adding the following `.yml` config:
|
|
|
|
```yml
|
|
SilverStripe\Forms\GridField\GridFieldDetailForm_ItemRequest:
|
|
formActions:
|
|
showPagination: false
|
|
showAdd: false
|
|
```
|
|
|
|
You can also override this for a specific `GridField` instance when using the `GridFieldConfig_RecordEditor` constructor:
|
|
|
|
```php
|
|
$grid = new GridField(
|
|
"pages",
|
|
"All Pages",
|
|
SiteTree::get(),
|
|
GridFieldConfig_RecordEditor::create(null, false, false));
|
|
```
|
|
|
|
## Related
|
|
|
|
* [How to extend the CMS interface](extend_cms_interface)
|