WoltLab Suite 6.2 Handbuch
Deutsch/PHP-Version: Die Website-Struktur, Navigation und Überschriften sind auf Deutsch vorbereitet. Code-Beispiele und technische Namen bleiben unverändert.

Migrating from WoltLab Suite 6.1 - PHP

User Activity Events

User activity events can optionally be provided with an image.

The setImage() method expects an object of type wcf\system\file\processor\ImageData as a parameter.

Classes that implement the interface wcf\system\file\processor\IImageDataProvider provide the getImageData() method,

that returns a suitable ImageData object.

Example

$object = new FooBarObject(1);
$event->setTitle(WCF::getLanguage()->getDynamicVariable('com.foo.bar', [
    // variables
]));
$event->setDescription(
    StringUtil::encodeHTML(
        StringUtil::truncate($object->getPlainTextMessage(), 500)
    ),
    true
);
$event->setLink($object->getLink());
$event->setImage(new ImageData('image_src', 800, 600));

User Profile Header

The header in the user profile has been completely overhauled.

Main goal of this change is the overhaul of the visuals of the user profile header.

At the same time, the use of a view removes a lot of business logic from the templates and simplifies extensibility through a clear API.

Stats

You can add your own counters to the user profile header via a dedicated event. The use of template listeners is no longer necessary.

Example:

EventHandler::getInstance()->register(
    \wcf\event\user\profile\UserProfileStatItemCollecting::class,
    static function (\wcf\event\user\profile\UserProfileStatItemCollecting $event) {
        if ($event->user->exampleCounter) {
            $event->register(\wcf\system\view\user\profile\UserProfileStatItem::forLink(
                WCF::getLanguage()->get('phrase.exampleCounter'),
                StringUtil::formatNumeric($event->user->exampleCounter),
                LinkHandler::getInstance()->getControllerLink(
                    \example\page\ExampleListPage::class,
                    ['object' => $event->user]
                )
            ));
        }
    }
);

Suche Content Links

Additional links for searching for content can also be added via a dedicated event.

Example:

EventHandler::getInstance()->register(
    \wcf\event\user\profile\UserProfileHeaderSearchContentLinkCollecting::class,
    static function (\wcf\event\user\profile\UserProfileHeaderSearchContentLinkCollecting $event) {
        if ($event->user->exampleCounter) {
            $event->register(new \wcf\system\view\user\profile\UserProfileHeaderViewSearchContentLink(
                WCF::getLanguage()->get('phrase.exampleCounter'),
                LinkHandler::getInstance()->getControllerLink(
                    \example\page\ExampleListPage::class,
                    ['object' => $event->user]
                )
            ));
        }
    }
);

Interactions

Two different interaction menus are available in the user profile header.

Corresponding events are available for both menus to add custom menu items.

An example of this can be found in the interaction documentation.

| Type | Class Name | Event Class Name |

|-----------------------------|------------------------------|---------------------------------------|

| General interactions. | UserProfileInteractions | UserProfileInteractionCollecting |

| Administrative interactions | UserManagementInteractions | UserManagementInteractionCollecting |

Deleted Content Provider

A new interface IDeletedContentListViewProvider for displaying deleted content in the moderator panel based on a list view has been added.

An abstract implementation of the interface is also available: AbstractDeletedContentListViewProvider

Example:

class DeletedExampleProvider extends AbstractDeletedContentListViewProvider
{
    #[\Override]
    public function getListView(): AbstractListView
    {
        return new DeletedExampleListView();
    }
}

Taggable Content

A new interface ITaggedListViewProvider for displaying tagged content based on a list view has been added.

An abstract implementation of the interface is also available: AbstractTaggedListViewProvider

Example:

class TaggableExample extends AbstractTaggedListViewProvider
{
    #[\Override]
    public function getListView(array $tagIDs): AbstractListView
    {
        return new TaggedExampleListView($tagIDs);
    }
}

Grid Views

The following pages have been migrated to grid views.

Plugins that have been hooked into these pages via event or template listeners must be adapted accordingly.

An example how to add additional columns to an existing grid view can be found in the grid view documentation.

List Views

The following pages have been migrated to list views.

Plugins that have been hooked into these pages via event or template listeners must be adapted accordingly.

An example how to add additional sort fields can be found in the list view documentation.

Forms

The following forms have been migrated to FormBuilder forms.

Plugins that have been hooked into these forms via event or template listeners must be adapted accordingly.