contentacms/contenta_jsonapi

Saturday, July 28, 2018
by dawehner
Repository
24 Watchers
195 Stars
9,315 Installations

PHP
4 Dependents
0 Suggesters
59 Forks
33 Open issues
82 Versions
32 % Grown

The README.md

Contenta CMS

DEPRECATED. Contenta CMS was an educational distribution to show examples of best practices for decoupled projects. Decoupled Drupal has been stable for a long time and the relevance of this project has dwindled over the years. Additionally, since no one has stepped up to fill the maintainer role, I have decided to archive this project. Thanks to everyone who participated to this project over the years., _(*1)

LOOKING FOR HELP TO MAINTAIN CONTENTA. It has been a while since I have found the motivation to keep Contenta CMS up-to-date and improved. I don't anticipate this changing in the near future. Please reach out if you would like to step up as a new maintainer of this project., _(*2)

Contenta is a content API and CMS based on Drupal 8. It provides a standard, jsonapi-based platform for building decoupled applications and websites., _(*3)

Install

Follow the documentation instructions to install Contenta CMS., _(*4)

CURL

Once your site is running locally, you might want to use Curl to examine the pre-installed content:, _(*5)

curl --header 'Accept: application/vnd.api+json' http://127.0.0.1:8888/api/recipes

The result will be a list of recipes. Note that:, _(*6)

The Drupal implementation of the jsonapi uses entity uuids to identify individual content resources. Append a /{{uuid}} to the URL above to fetch a single recipe.
Contenta uses the JSON API Extras module to customize the URL to resources: /api/recipes instead of /jsonapi/node/recipes, for example. Contenta also configures JSON API Extras to customize the output of the request to eliminate unnecessary fields.

CORS

When you actually build a front-end you will likely have CORS (Cross-Origin Resource Sharing) issues., _(*7)

In order to allow browsers to request the contenta back-end you need to:, _(*8)

Copy sites/default/default.services.yml to sites/default/services.yml
Allow your app to access it, by replacing the end of this configuration file.

  cors.config:
    enabled: true
    allowedHeaders:
      - '*'
    allowedMethods:
      - '*'
    allowedOrigins:
       # Note: you need to specify the host + port where your app will run.
      - localhost:8000
    exposedHeaders: false
    maxAge: false
    supportsCredentials: false

Run drush: cd <DESTINATION>/web && ../vendor/bin/drush cr

Development

Join the discussion in the #contenta Slack channel., _(*9)

For documention on the development on contenta_jsonapi itself, see docs/development., _(*10)

Code of conduct, _(*11)

Development Installation

If you want a setup which allows you to contribute back to Contenta, follow the installation instructions above
Replace the /web/profiles/contrib/contenta_jsonapi directory with a checkout of this repo

cd -DESTINATION-
rm -rf web/profiles/contrib/contenta_jsonapi
git clone git@github.com:contentacms/contenta_jsonapi.git web/profiles/contrib/contenta_jsonapi

Testing

Nightwatch

Nightwatch provides automated browser testing and can be found in the tests/nightwatch directory. To install and run locally, you will need Yarn and Chrome., _(*12)

yarn install
yarn run nightwatch

Front-ends

There are a bunch of example consumers, see http://www.contentacms.org/#example-consumers for a list of them., _(*13)

Update

Contenta CMS is a Fork & Go solution. There is no supported upgrade path. You may update your Drupal like you usually do., _(*14)

Please see documented issues : - Proper way to update contenta cms - Can not update with composer, _(*15)

Credits

This work is based upon a couple of contrib modules., _(*16)

On top of that the thunder distrbution was used as sort of a base for this installation profile., _(*17)

Contenta CMS is built by humans., _(*18)

The Versions

28/07 2018

drupal-profile contenta_jsonapi

contentacms/contenta_jsonapi

The README.md

Contenta CMS

Install

CURL

CORS

Development

Development Installation

Testing

Nightwatch

Front-ends

Update

Credits

The Versions

dev-8.x-2.x

The Requires

The Development Requires

dev-new-content-model

The Requires

The Development Requires

dev-8.x-1.x

The Requires

The Development Requires

dev-fix-tests

The Requires

The Development Requires

v1.512

The Requires

The Development Requires

dev-redis-share

The Requires

The Development Requires

v1.508

The Requires

The Development Requires

v1.507

The Requires

The Development Requires

v1.497

The Requires

The Development Requires

dev-fix/272--bring-back-embeddable-resource

The Requires

The Development Requires

v1.494

The Requires

The Development Requires

dev-276--media-in-core

The Requires

The Development Requires

v1.484

The Requires

The Development Requires

v1.481

The Requires

The Development Requires

v1.479

The Requires

The Development Requires

v1.477

The Requires

The Development Requires

v1.476

The Requires

The Development Requires

dev-262--use-the-new-disabled-method

The Requires

The Development Requires

v1.474

The Requires

The Development Requires

v1.468

The Requires

The Development Requires

v1.467

The Requires

The Development Requires

dev-feat/245--allow-disable-contenta_enhancement

The Requires