Search

• Home
• Getting Started
• Tutorials
• Developer Guides
  • Model and Databases
    • Introduction to the Data Model and ORM
    • Relations between Records
    • Managing Lists
    • Data Types, Overloading and Casting
    • Extending DataObjects
    • SearchFilter Modifiers
    • Model-Level Permissions
    • SQL Queries
    • Model Validation and Constraints
    • Versioning
    • Building Model and Search Interfaces around Scaffolding
    • Indexes
    • How Tos
  • Templates and Views
  • Controllers
  • Forms
  • Configuration
  • Extending SilverStripe
  • Testing
  • Debugging
  • Performance
  • Security
  • Email
  • Integration and Web Services
  • Search
  • i18n
  • Files
  • Customising the Admin Interface
  • Execution Pipeline
  • Command Line Interface
  • Cookies and Sessions
• Upgrading
• Changelogs
• Contributing

Dynamic Default Values

The DataObject::$defaults array allows you to specify simple static values to be the default values when a record is created, but in many situations default values need to be dynamically calculated. In order to do this, the DataObject::populateDefaults() method will need to be overloaded.

This method is called whenever a new record is instantiated, and you must be sure to call the method on the parent object!

A simple example is to set a field to the current date and time:

/**
 * Sets the Date field to the current date.
 */
public function populateDefaults() {
    $this->Date = date('Y-m-d');
    parent::populateDefaults();
}

It's also possible to get the data from any other source, or another object, just by using the usual data retrieval methods. For example:

/**
 * This method combines the Title of the parent object with the Title of this
 * object in the FullTitle field.
 */
public function populateDefaults() {
    if($parent = $this->Parent()) {
        $this->FullTitle = $parent->Title . ': ' . $this->Title;
    } else {
        $this->FullTitle = $this->Title;
    }
    parent::populateDefaults();
}