README

Partner/logo administration and frontend presentation for DravenCMS. Partner records combine descriptive content, managed files, ordering, activation, and tags.

Features

• Partner administration with file and tag integration.
• Ordered and active partner records.
• Overview, main, and bar frontend components.
• CMS component integration through DravenCMS Structure.
• Provider-defined admin navigation and ACL permissions.

Installation

composer require dravencms/partner

The package loader registers the extension, admin presenter, component factories, repositories, and Doctrine mappings. Apply the package schema through the application's normal workflow; assign provider-defined permissions through the group editor.

Frontend Integration

With dravencms/structure installed, the package exposes three CMS components:

• Partner Overview
• Partner Main
• Partner Bar

The overview and bar factories require an ICmsActionOption; the main factory also supports creation without one. Applications can inject these factories directly when rendering partners outside the CMS page builder.

Partner images are managed through dravencms/file, and classifications use dravencms/tag. Preserve those relationships when importing or deleting records so file cleanup and tag queries remain accurate.

License

This package is licensed under the LGPL-3.0 license.

Admin authorization and mutations

Administration uses User 3.1, Admin 3.2 and Application 0.3 guards. Screens and write callbacks enforce the existing provider-defined permissions server-side, including direct URLs and bulk callbacks. Mutating signals require POST and a session-bound action token; synchronize the matching admin assets when upgrading. See the User package's user:security:migrate instructions for the password-reset schema change.

Contextual file delivery

This release requires Dravencms File 3 / Nette Files 3. Image URLs include a specific file resolver and attachment reference; templates no longer pass bare files. Published attachments are public-cacheable; admin previews of unpublished content require the plugin's edit permission and are private. Original files and generated images stay outside the document root. Install the private-storage configuration and run File's checksum/storage migrations before serving this release. See the File package README.

Variant configuration (3.1)

This package declares its own variants in dravencms.config.neon; Nette merges the files.variants maps. Definitions use named width, height and resizeMode fields. resizeMode defaults to fit; an omitted/null dimension is unconstrained, and at least one dimension is required. On upgrade, replace old positional definitions and remove variants owned by other packages from the File configuration. Project variants belong in project configuration. Update the matching File, Nette Files and installed Gallery/Article/Partner/Carousel releases together. No additional database or storage migration is needed for this configuration change.