root/trunk/lib/form/shared/BaseConnectionForm.class.php

<?php
/**
 * Base form class to represent a connection between two resources. In the
 * Symfonians app, these resources connection can be between:
 *
 *  - an Application and a Company
 *  - an Application and a sfGuardUser
 *  - a sfGuardUser and a Company
 *
 * Provided fields are:
 *
 *  - role:       the role of the resource which is connected to the other one
 *  - started at: the date the connection started
 *  - ended_at:   the date the connection stopped
 *
 * Typical use is to merge a new instance of this form object with one of your
 * form, not by extending it. This way you'll have the provided widgets and
 * validators available in your own form. By example:
 *
 *     class myForm extends sfForm
 *     {
 *       public function configure()
 *       {
 *         $this->mergeForm(new BaseConnectionForm());
 *       }
 *     }
 *
 * @package form
 */
class BaseConnectionForm extends sfForm
{
  /**
   * Form configuration
   *
   */
  public function setup()
  {
    $years = range(date('Y') - 5, date('Y'));
    $years = array_combine($years, $years);
    $dateConfig = array('culture' => sfContext::getInstance()->getUser()->getCulture(),
                        'years'   => $years);

    // Widgets
    $this->setWidgets(array(
      'role'        => new sfWidgetFormInput(),
      'description' => new sfWidgetFormTextarea(),
      'started_at'  => new sfWidgetFormI18nDate($dateConfig),
      'ended_at'    => new sfWidgetFormI18nDate($dateConfig),
    ));

    // Validators
    $this->setValidators(array(
      'role'        => new sfValidatorString(array('max_length' => 255, 'required' => true)),
      'description' => new sfValidatorString(array('max_length' => 65535, 'required' => false)),
      'started_at'  => new sfValidatorDate(array('required' => false)),
      'ended_at'    => new sfValidatorDate(array('required' => false)),
    ));

    $this->validatorSchema->setPostValidator(new sfValidatorSchemaTimeInterval('started_at', 'ended_at'));

    $this->widgetSchema->setNameFormat('connection[%s]');
  }
}