sulu/article-bundle

Bundle for managing localized content-rich entities like blog-posts in the Sulu content management system

2.6.4 2024-10-31 10:59 UTC

Requires

• php: ^7.3 || ^8.0
• ext-json: *
• elasticsearch/elasticsearch: ^5.0 || ^6.0 || ^7.0
• handcraftedinthealps/elasticsearch-bundle: ^5.2.6.4 || ^5.2.6.4@dev
• handcraftedinthealps/elasticsearch-dsl: ^5.0.7.1 || ^6.2.0.1 || ^7.2.0.1
• jms/serializer: ^3.3
• jms/serializer-bundle: ^3.3 || ^4.0 || ^5.0
• sulu/sulu: ~2.4.13 || ^2.5.9@dev
• symfony-cmf/slugifier-api: ^1.0 || ^2.0
• symfony/config: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/dependency-injection: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/http-foundation: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/http-kernel: ^4.3 || ^5.0 || ^6.0 || ^7.0
• twig/twig: ^1.41 || ^2.0 || ^3.0

Requires (Dev)

• doctrine/data-fixtures: ^1.1
• handcraftedinthealps/zendsearch: ^2.0
• jackalope/jackalope-doctrine-dbal: ^1.3.4 || ^2.0
• jackalope/jackalope-jackrabbit: ^1.3 || ^2.0
• jangregor/phpstan-prophecy: ^1.0
• massive/build-bundle: ^0.3 || ^0.4 || ^0.5
• php-cs-fixer/shim: ^3.0
• phpcr/phpcr-shell: ^1.1
• phpspec/prophecy: ^1.15
• phpstan/phpstan: ^1.0
• phpstan/phpstan-doctrine: ^1.0
• phpstan/phpstan-phpunit: ^1.0
• phpstan/phpstan-symfony: ^1.0
• phpstan/phpstan-webmozart-assert: ^1.0
• phpunit/phpunit: ^8.2
• sulu/automation-bundle: ^2.0 || ^2.1@dev
• sulu/headless-bundle: ^0.8 || ^0.9 || ^0.10@dev
• symfony/browser-kit: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/dotenv: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/framework-bundle: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/monolog-bundle: ^3.1
• symfony/security-bundle: ^4.3 || ^5.0 || ^6.0 || ^7.0
• symfony/stopwatch: ^4.3 || ^5.0 || ^6.0 || ^7.0

Suggests

• sulu/automation-bundle: Allows to outsource long-running route update processes.

Conflicts

• guzzlehttp/ringphp: <1.1.1
• sulu/automation-bundle: <2.0 || >=3.0
• sulu/headless-bundle: <0.8 || >=0.11

MIT

• Sulu Article

• blog
• news
• articles
• publishing
• sulu

README

The SuluArticleBundle integrates a performance optimized way for managing articles in the Sulu content management system. In the context of this bundle, articles are localized content-rich entities that are manageable via the Sulu administration interface and can be rendered on a website delivered by Sulu. This makes them a good choice for managing things like blog posts, products or even recipes in a Sulu project. In order to keep things clean, the bundle allows to manage different types of articles via separated lists in the administration interface.

The SuluArticleBundle is compatible with Sulu starting from version 2.0. Have a look at the require section in the composer.json to find an up-to-date list of the requirements of the bundle.

🚀  Installation and Documentation

Execute the following composer commands to add the bundle to the dependencies of your project:

composer require "elasticsearch/elasticsearch:7.17.*" # should match version of your elasticsearch installation
composer require sulu/article-bundle

Afterwards, visit the bundle documentation to find out how to set up and configure the SuluArticleBundle to your specific needs.

💡  Key Concepts

Article Characteristics

Like Sulu pages, articles are configured via templates and can include additional SEO and excerpt information. Moreover, articles support the same drafting, publishing and versioning functionality as provided by pages. In contrast to Sulu pages, articles are managed in a flat list instead of a tree structure. Furthermore, unlike the Sulu page tree, the article bundle is optimized for managing a big number of articles.

Elasticsearch dependency

The SuluArticleBundle was originally developed to be used in the publishing industry. To satisfy the initial requirements regarding performance and scalability, a view layer stored in an Elasticsearch index was utilized. Because of this, there is no way to use the bundle without Elasticsearch at the moment. It is planned to remove this hard dependency in the next major version.

If you cannot or do not want to make Elasticsearch a dependency of your project, you can use Sulu pages for certain use cases instead of the SuluArticleBundle. However, be aware that the article list provides a better performance and is more comfortable to use with a large number of entities.

❤️  Support and Contributions

The Sulu content management system is a community-driven open source project backed by various partner companies. We are committed to a fully transparent development process and highly appreciate any contributions.

In case you have questions, we are happy to welcome you in our official Slack channel. If you found a bug or miss a specific feature, feel free to file a new issue with a respective title and description on the the sulu/SuluArticleBundle repository.

📘  License

The Sulu content management system is released under the under terms of the MIT License.