Merge branch '4.0' into 4

Author: emteknetnz

.doclintrc

@@ -0,0 +1 @@
+docs/en/

README.md

@@ -13,7 +13,7 @@ composer require silverstripe/tagfield
 
 ## Overview
 
-![Screenshot](docs/en/screenshot.png)
+![Screenshot](docs/en/_images/screenshot.png)
 
 Allows storing tags as a relationship, or comma-delimited strings.
 Supports autocompletion with lazy-loading.
@@ -127,7 +127,7 @@ $field = StringTagField::create(
 $field->setShouldLazyLoad(true); // tags should be lazy loaded
 ```
 
-You can find more in-depth documentation in [docs/en](docs/en/introduction.md).
+You can find more in-depth documentation in the [documentation](https://docs.silverstripe.org/en/optional_features/tagfield).
 
 ## Using TagField with silverstripe-taxonomy
 

composer.json

@@ -27,6 +27,7 @@
         "phpunit/phpunit": "^11.3",
         "squizlabs/php_codesniffer": "^3",
         "silverstripe/standards": "^1",
+        "silverstripe/documentation-lint": "^1",
         "phpstan/extension-installer": "^1.3"
     },
     "autoload": {
@@ -40,6 +41,11 @@
             "client/dist"
         ]
     },
+    "config": {
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true
+        }
+    },
     "minimum-stability": "dev",
     "prefer-stable": true
 }

docs/en/01_usage.md

@@ -0,0 +1,114 @@
+---
+title: TagField Module Usage
+summary: Managing tags on DataObjects, and integration with silverstripe-taxonomy
+icon: tags
+---
+
+# Usage
+
+The primary use, for this module, is as a custom input field interface. For instance, imagine you had the following data objects:
+
+```php
+namespace App\Models;
+
+use SilverStripe\Blog\Model\BlogTag;
+use SilverStripe\ORM\DataObject;
+
+class BlogPost extends DataObject
+{
+    private static $many_many = [
+        'BlogTags' => BlogTag::class,
+    ];
+}
+```
+
+```php
+namespace App\Models;
+
+use SilverStripe\Blog\Model\BlogPost;
+use SilverStripe\ORM\DataObject;
+
+class BlogTag extends DataObject
+{
+    private static $db = [
+        'Title' => 'Varchar(200)',
+    ];
+
+    private static $belongs_many_many = [
+        'BlogPosts' => BlogPost::class,
+    ];
+}
+```
+
+If you wanted to link blog tags to blog posts, you might override [`DataObject::getCMSFields()`](api:SilverStripe\ORM\DataObject::getCMSFields()) with the following field:
+
+```php
+use SilverStripe\Blog\Model\BlogTag;
+use SilverStripe\TagField\TagField;
+
+$field = TagField::create(
+    'BlogTags',
+    'Blog Tags',
+    BlogTag::get(),
+    $this->BlogTags()
+)
+    // tags should be lazy loaded
+    ->setShouldLazyLoad(true)
+    // new tag DataObjects can be created
+    ->setCanCreate(true);
+```
+
+This will present a tag field, in which you can select existing blog tags or create new ones. They will be created/linked after the blog posts are saved.
+
+## StringTagField
+
+You can also store string-based tags, with the following field type:
+
+```php
+use SilverStripe\TagField\StringTagField;
+
+$field = StringTagField::create(
+    'Tags',
+    'Tags',
+    ['one', 'two'],
+    explode(',', $this->Tags)
+)
+    ->setCanCreate(true)
+    ->setShouldLazyLoad(true);
+```
+
+This assumes you are storing tags in the following data object structure:
+
+```php
+namespace App\Models;
+
+use SilverStripe\ORM\DataObject;
+
+class BlogPost extends DataObject
+{
+    private static $db = [
+        'Tags' => 'Text',
+    ];
+}
+```
+
+In the above code example, the options available (whether lazy loaded or not) would be "one" and "two", and the
+user would be able to create new options. Whichever tags are chosen would be stored in the BlogPost's `Tags` field
+as a comma-delimited string.
+
+## Using tagfield with silverstripe-taxonomy
+
+TagField assumes that objects have a `Title` field. For classes without a `Title` field
+use [`TagField::setTitleField()`](api:SilverStripe\TagField\TagField::setTitleField()) to modify accordingly.
+
+```php
+use SilverStripe\TagField\TagField;
+use SilverStripe\Taxonomy\TaxonomyTerm;
+
+$field = TagField::create(
+    'Tags',
+    'Blog Tags',
+    TaxonomyTerm::get()
+)
+    ->setTitleField('Name');
+```

docs/en/screenshot.png docs/en/_images/screenshot.pngdocs/en/screenshot.png renamed to docs/en/_images/screenshot.png

@@ -0,0 +1,21 @@
+---
+title: TagField
+summary: Provides a custom form field for adding tags to content, supporting either related data objects or simple string-based tags
+icon: tags
+---
+
+# TagField
+
+The TagField module provides a custom form field for adding tags to content. It supports creating tags as related data objects or as a simple comma-separated list of strings.
+
+## Installation
+
+```bash
+composer require silverstripe/tagfield
+```
+
+## GitHub repository
+
+<https://github.com/silverstripe/silverstripe-tagfield>
+
+[CHILDREN]