Update outdated code examples

BurntimeX · BurntimeX · commit f67ea8269105 · 2025-11-28T18:14:51.000+01:00
diff --git a/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/Person.class.php b/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/Person.class.php
@@ -8,9 +8,9 @@
 /**
  * Represents a person.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
  * @property-read   int     $personID   unique id of the person
  * @property-read   string  $firstName  first name of the person
diff --git a/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonAction.class.php b/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonAction.class.php
@@ -7,23 +7,10 @@
 /**
  * Executes person-related actions.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method  Person      create()
- * @method  PersonEditor[]  getObjects()
- * @method  PersonEditor    getSingleObject()
+ * @extends AbstractDatabaseObjectAction<Person, PersonEditor>
  */
-class PersonAction extends AbstractDatabaseObjectAction
-{
-    /**
-     * @inheritDoc
-     */
-    protected $permissionsDelete = ['admin.content.canManagePeople'];
-
-    /**
-     * @inheritDoc
-     */
-    protected $requireACP = ['delete'];
-}
+class PersonAction extends AbstractDatabaseObjectAction {}
diff --git a/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonEditor.class.php b/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonEditor.class.php
@@ -7,13 +7,12 @@
 /**
  * Provides functions to edit people.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method static   Person  create(array $parameters = [])
- * @method      Person  getDecoratedObject()
- * @mixin       Person
+ * @mixin   Person
+ * @extends DatabaseObjectEditor<Person>
  */
 class PersonEditor extends DatabaseObjectEditor
 {
diff --git a/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonList.class.php b/snippets/tutorial/tutorial-series/part-1/files/lib/data/person/PersonList.class.php
@@ -7,13 +7,10 @@
 /**
  * Represents a list of people.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method  Person      current()
- * @method  Person[]    getObjects()
- * @method  Person|null search($objectID)
- * @property    Person[]    $objects
+ * @extends DatabaseObjectList<Person>
  */
 class PersonList extends DatabaseObjectList {}
diff --git a/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonAction.class.php b/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonAction.class.php
@@ -7,23 +7,10 @@
 /**
  * Executes person-related actions.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method  Person      create()
- * @method  PersonEditor[]  getObjects()
- * @method  PersonEditor    getSingleObject()
+ * @extends AbstractDatabaseObjectAction<Person, PersonEditor>
  */
-class PersonAction extends AbstractDatabaseObjectAction
-{
-    /**
-     * @inheritDoc
-     */
-    protected $permissionsDelete = ['admin.content.canManagePeople'];
-
-    /**
-     * @inheritDoc
-     */
-    protected $requireACP = ['delete'];
-}
+class PersonAction extends AbstractDatabaseObjectAction {}
diff --git a/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonEditor.class.php b/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonEditor.class.php
@@ -7,13 +7,12 @@
 /**
  * Provides functions to edit people.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method static   Person  create(array $parameters = [])
- * @method      Person  getDecoratedObject()
- * @mixin       Person
+ * @mixin   Person
+ * @extends DatabaseObjectEditor<Person>
  */
 class PersonEditor extends DatabaseObjectEditor
 {
diff --git a/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonList.class.php b/snippets/tutorial/tutorial-series/part-3/files/lib/data/person/PersonList.class.php
@@ -7,13 +7,10 @@
 /**
  * Represents a list of people.
  *
- * @author  Matthias Schmidt
+ * @author      Matthias Schmidt
  * @copyright   2001-2021 WoltLab GmbH
- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  *
- * @method  Person      current()
- * @method  Person[]    getObjects()
- * @method  Person|null search($objectID)
- * @property    Person[]    $objects
+ * @extends DatabaseObjectList<Person>
  */
 class PersonList extends DatabaseObjectList {}

Original file line number	Diff line number	Diff line change
`@@ -8,9 +8,9 @@`
`8`	`8`	`/**`
`9`	`9`	`* Represents a person.`
`10`	`10`	`*`
`11`		`- * @author Matthias Schmidt`
	`11`	`+ * @author Matthias Schmidt`
`12`	`12`	`* @copyright 2001-2021 WoltLab GmbH`
`13`		`- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>`
	`13`	`+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>`
`14`	`14`	`*`
`15`	`15`	`* @property-read int $personID unique id of the person`
`16`	`16`	`* @property-read string $firstName first name of the person`
Original file line number	Diff line number	Diff line change
`@@ -7,13 +7,12 @@`
`7`	`7`	`/**`
`8`	`8`	`* Provides functions to edit people.`
`9`	`9`	`*`
`10`		`- * @author Matthias Schmidt`
	`10`	`+ * @author Matthias Schmidt`
`11`	`11`	`* @copyright 2001-2021 WoltLab GmbH`
`12`		`- * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>`
	`12`	`+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>`
`13`	`13`	`*`
`14`		`- * @method static Person create(array $parameters = [])`
`15`		`- * @method Person getDecoratedObject()`
`16`		`- * @mixin Person`
	`14`	`+ * @mixin Person`
	`15`	`+ * @extends DatabaseObjectEditor<Person>`
`17`	`16`	`*/`
`18`	`17`	`class PersonEditor extends DatabaseObjectEditor`
`19`	`18`	`{`