Changeset 64095

Timestamp:

12/10/08 07:46:56 (7 weeks ago)

Author:

ischommer

Message:

ENHANCEMENT Added getters/setters for $tagTopicClass in TagField?
MINOR Documentation for TagField?

Files:

• modules/tagfield/trunk/code/TagField.php (modified) (3 diffs)

modules/tagfield/trunk/code/TagField.php

@@ -9 +9 @@
  * - Autosuggest functionality (currently JSON only)
  * 
+ * Example Datamodel and Instanciation:
+ * <code>
+ * class Article extends DataObject {
+ *      static $many_many = array('Tags'=>'Tag');
+ * }
+ * class Tag extends DataObject {
+ *      static $db = array('Title'=>'Varchar');
+ *      static $belongs_many_many = array('Articles'=>'Article');
+ * }
+ * </code>
+ * <code>
+ * $form = new Form($this,'Form',
+ *      new FieldSet(
+ *              new TagField('Tags', 'My Tags', null, 'Article')
+ *      )
+ *      new FieldSet()
+ * );
+ * $form->loadDataFrom($myArticle);
+ * $form->saveInto($myArticle);
+ * </code>
+ * 
  * @author Ingo Schommer, SilverStripe Ltd. (<firstname>@silverstripe.com)
  * @package formfields
@@ -53 +74 @@
         protected $customTags;
         
-        function __construct($name, $title = null, $value = null, $tagTopicClass) {
+        function __construct($name, $title = null, $value = null, $tagTopicClass = null) {
                 $this->tagTopicClass = $tagTopicClass;
                 
@@ -129 +150 @@
         }
         
+        /**
+         * @param string $class Classname of the DataObject which contains
+         * the relation or field for tags.
+         */
+        public function setTagTopicClass($class) {
+                $this->tagTopicClass = $class;
+        }
+        
+        /**
+         * @return string Classname
+         */
+        public function getTagTopicClass() {
+                return $this->tagTopicClass;
+        }
+        
         protected function saveIntoObjectTags($record) {
                 // HACK We can't save relationship tables without having an ID