From a224678d980843f034b13ff9825db18eaef9e1f2 Mon Sep 17 00:00:00 2001 From: JorisDebonnet Date: Thu, 29 May 2014 00:51:27 +0200 Subject: [PATCH] Update modeladmin.md Corrected many broken link-renderings. Also removed the "Related" link to [genericviews Module](http://silverstripe.org/generic-views-module) because it doesn't work, and I can't it elswhere. --- docs/en/reference/modeladmin.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/en/reference/modeladmin.md b/docs/en/reference/modeladmin.md index b6d3477b6..51de380e1 100644 --- a/docs/en/reference/modeladmin.md +++ b/docs/en/reference/modeladmin.md @@ -9,7 +9,7 @@ It uses the framework's knowledge about the model to provide sensible defaults, allowing you to get started in a couple of lines of code, while still providing a solid base for customization. -The interface is mainly powered by the `[GridField](/reference/grid-field)` class, +The interface is mainly powered by the [GridField](/reference/grid-field) class, which can also be used in other CMS areas (e.g. to manage a relation on a `SiteTree` record in the standard CMS interface). @@ -17,7 +17,7 @@ record in the standard CMS interface). Let's assume we want to manage a simple product listing as a sample data model: A product can have a name, price, and a category. - + :::php class Product extends DataObject { private static $db = array('Name' => 'Varchar', 'ProductCode' => 'Varchar', 'Price' => 'Currency'); @@ -74,13 +74,13 @@ less restrictive checks make sense, e.g. checking for general CMS access rights. ## Search Fields -ModelAdmin uses the `[SearchContext](/reference/searchcontext)` class to provide +ModelAdmin uses the [SearchContext](/reference/searchcontext) class to provide a search form, as well as get the searched results. Every DataObject can have its own context, based on the fields which should be searchable. The class makes a guess at how those fields should be searched, e.g. showing a checkbox for any boolean fields in your `$db` definition. -To remove, add or modify searchable fields, define a new `[$searchable_fields](api:DataObject::$searchable_fields)` -static on your model class (see `[SearchContext](/reference/searchcontext)` docs for details). +To remove, add or modify searchable fields, define a new `[api:DataObject::$summary_fields]` +static on your model class (see [SearchContext](/reference/searchcontext) docs for details). :::php class Product extends DataObject { @@ -93,11 +93,11 @@ static on your model class (see `[SearchContext](/reference/searchcontext)` docs } For a more sophisticated customization, for example configuring the form fields -for the search form, override `[api:DataObject->getCustomSearchContext()]` on your model class. +for the search form, override `DataObject->getCustomSearchContext()` on your model class. ## Result Columns -The results are shown in a tabular listing, powered by the `[GridField](/reference/grid-field)`, +The results are shown in a tabular listing, powered by the [GridField](/reference/grid-field), more specifically the `[api:GridFieldDataColumns]` component. It looks for a `[api:DataObject::$summary_fields]` static on your model class, where you can add or remove columns. To change the title, use `[api:DataObject::$field_labels]`. @@ -203,10 +203,10 @@ Has-one relationships are simply implemented as a `[api:DropdownField]` by defau Consider replacing it with a more powerful interface in case you have many records (through customizing `[api:DataObject->getCMSFields]`). -Has-many and many-many relationships are usually handled via the `[GridField](/reference/grid-field)` class, +Has-many and many-many relationships are usually handled via the [GridField](/reference/grid-field) class, more specifically the `[api:GridFieldAddExistingAutocompleter]` and `[api:GridFieldRelationDelete]` components. They provide a list/detail interface within a single record edited in your ModelAdmin. -The `[GridField](/reference/grid-field)` docs also explain how to manage +The [GridField](/reference/grid-field) docs also explain how to manage extra relation fields on join tables through its detail forms. The autocompleter can also search attributes on relations, based on the search fields defined through `[api:DataObject::searchableFields()]`. @@ -287,7 +287,7 @@ Interfaces like `ModelAdmin` can be customized in many ways: * HTML markup through templates In general, use your `ModelAdmin->init()` method to add additional requirements -through the `[Requirements](/reference/requirements)` API. +through the [Requirements](/reference/requirements) API. For an introduction how to customize the CMS templates, see our [CMS Architecture Guide](/reference/cms-architecture). ## Related