PHPackages yanc3k/api-content-provider-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. yanc3k/api-content-provider-bundle ActiveSymfony-bundle yanc3k/api-content-provider-bundle ================================== Bundle to enable headless content providing for the Sulu CMS, which is open source and Symfony based. 1.0.1(7y ago)08MITPHPPHP >=5.6 Since Jun 10Pushed 7y agoCompare [ Source](https://github.com/yanc3k/ApiContentProviderBundle)[ Packagist](https://packagist.org/packages/yanc3k/api-content-provider-bundle)[ Docs](http://yanc3k.github.com)[ RSS](/packages/yanc3k-api-content-provider-bundle/feed)WikiDiscussions master Synced 5d ago READMEChangelogDependencies (8)Versions (3)Used By (0) README ====== [](#readme) This Bundles purpose is to enable the Open Source CMS Sulu to serve as a headless back-end. Content pages can be created in the Sulu admin area. All returned content data is stored in simple key-value-pairs. The keys can be set freely and the content is created like in usual Sulu applications. Use it for ReactJs or Angular WebApps or React Native, native, Expo JS or other mobile apps. Available Sulu Content Types ============================ [](#available-sulu-content-types) Sulu offers many different content types. A content type may be something like a text line input, a full text editor or a media selection for images and other files. Since they may differ a lot in the way they need to be handled for headless usage, they all need to be handled differently. By now I managed to implement the ones I identified as most important, at least for my situation. The following Sulu content types are available at the moment ------------------------------------------------------------ [](#the-following-sulu-content-types-are-available-at-the-moment) ### [Text line](http://docs.sulu.io/en/latest/reference/content-types/text_line.html) [](#text-line) Shows a simple text line, the inserted content will be saved as simple string. (From the Sulu CMS docs) ### [Text editor](http://docs.sulu.io/en/latest/reference/content-types/text_editor.html) [](#text-editor) Shows a rich text editor, capable of formatting text as well. The output of the editor will be stored as HTML in a string field. (From the Sulu CMS docs) ### [Media selection](http://docs.sulu.io/en/latest/reference/content-types/media_selection.html) [](#media-selection) Shows a list with the possibility to assign some assets from the media section to a page. Also allows to define a position, which can be handled later in the template. (From the Sulu CMS docs) Installation ============ [](#installation) Install the bundle using composer: ``` composer require yanc3k/api-content-provider-bundle ``` Enable the Bundle in the `app/AdminKernel.php` *AND* `app/WebsiteKernel.php` file: ***notice: This is done a little bit differently as in vanilla Symfony applications.*** ``` $bundles = [ ... $bundles[] = new yanc3k\ApiContentProviderBundle\ApiContentProviderBundle(); ... ]; ``` Usage ===== [](#usage) This bundle provides you with an easy way to create page content using the Sulu CMS as a headless back end. In Sulu you can easily create new templates for the CMS admin area. Those templates are written in XML. The ApiContentProviderBundle features a controller that can handle the data as it comes from Sulu on a page request. To use it you need to do two things, explained in detail below. ***Important:*** This is in no way interfering with other functionalities of Sulu. You won't lose anything by installing this bundle alongside a common setup. Easiest way ----------- [](#easiest-way) The ApiContentProviderBundle comes with a Sulu XML template ready to go. You need to copy it to your `app/Resources/templates/pages` folder. You can do that manually or by using this when in the project root: ``` cp vendor/yanc3k/api-content-provider-bundle/docs/Resources/api-content.xml app/Resources/templates/pages/ ``` From now on you can choose the api-content template in any content page in the Sulu CMS admim area. ### The Content page [](#the-content-page) The content page, defined by the XML template you just copied, features the following: - Definition of the title of the page, that will be present in the JSON reponse under the `title` key. - Definition of the URL the page content will be available at. This value will be included in the JSON response with the key `url`. - Definition of key-value-pairs that are used for the content you want to use in the frontend. ***IMPORTANT***Every key-value-pair must be ***one*** block! In each block you have the possibily to define a `key` that will be the key the content of this block will be stored under in the JSON response. Then you can set a value, or content, for this key. Only use one of the inputs (text line, text editor, media selection, ...). [![Screenshot of the page in Sulu with expanded key-value block](./docs/Resources/screenshot-text-editor.png)](./docs/Resources/screenshot-text-editor.png) The screenshot shows the content page in Sulu using the api-content template. There are three key-values defined. - One with the key `headline-1` and the value `this is a headline` - One with the key `image-user` and the value of a selcted image from the media library of the admin area. - One with the key `atricle-1` and the value of a formatted text written in a rich text editor. The response for a request to `http://canvas.lo/api-content-canvas` in the browser will return the following JSON. ***Note:*** The URL obove is based on my local setup and will differ based on the URL you defined in your virual host settings for your webserver. The `/api-content-canvas` part is defined in the content page and free of choice. ``` { "url": "/api-content-canvas", "title": "canvas", "headline-1": "this is a headline", "image-user": "/media/1/download/penguin.jpeg?v=1", "article-1": "yeah, this is a bold text\n\n \n\nasdasdad\n" } ``` Lets give that a litte more detail: The `url` in the response is the url you requested in the browser without locale and base URL. ``` "url": "/api-content-canvas", ``` The `title` in the response is the content page title defined in Sulu. ``` "title": "canvas", ``` The `headline-1` in the response is the first dynamic key in the JSON response. It is the one that was defined in the first key-value block in Sulu. The name of this key is entirely up to you. ``` "headline-1": "this is a headline", ``` The `image-user` key in the response is a media selection in Sulu. There you can chose a file from the easily manageable media library of Sulu. The relative path to that file will be returned. This path is versioned. ``` "image-user": "/media/1/download/penguin.jpeg?v=1", ``` The `article-1` key in the JSON response holds the content of a rich text editor input provided by Sulu. As you can see, it is HTML, that can be used in the front end, formatted as it is. ``` "article-1": "yeah, this is a bold text\n\n \n\nasdasdad\n" ``` ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 2898d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/30549204?v=4)[SolveCrew](/maintainers/solvecrew)[@solvecrew](https://github.com/solvecrew) --- Top Contributors [![yanc3k](https://avatars.githubusercontent.com/u/15339316?v=4)](https://github.com/yanc3k "yanc3k (7 commits)") --- Tags symfonycmsheadlesssulu ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/yanc3k-api-content-provider-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/yanc3k-api-content-provider-bundle/health.svg)](https://phpackages.com/packages/yanc3k-api-content-provider-bundle) ``` ### Alternatives [sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[simplesamlphp/simplesamlphp A PHP implementation of a SAML 2.0 service provider and identity provider. 1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[scheb/2fa Two-factor authentication for Symfony applications (please use scheb/2fa-bundle to install) 578630.7k1](/packages/scheb-2fa) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)