Skip to main content

JSON based CMS for Universal Core

Project description

Installation of Unicore CMS
===========================

.. code-block:: bash

$ virtualenv ve
$ source ve/bin/activate
(ve)$ pip install -e .

Running Unicore CMS for local development
-----------------------------------------

This is a Pyramid_ application, that uses Elasticsearch and Redis.

For OS X we recommend you install Elasticsearch and Redis with Brew_:

.. code-block:: bash

$ brew install elasticsearch
$ brew install redis

Start Elasticsearch in a separate Terminal tab:

.. code-block:: bash

$ elasticsearch

Start Redis in a separate Terminal tab:

.. code-block:: bash

$ redis-server

For Linux install them with your package manager (apt, rpm, yum etc...)
and make sure it's running as a service.

Then start the server:

.. code-block:: bash

(ve)$ pserve development.ini --reload

It'll run happily with the stock ``development.ini`` file provided but
it will be without any content.

For a better experience, load a content repository:

.. code-block:: bash

(ve)$ git clone https://github.com/universalcore/unicore-cms-content-ffl-tanzania repo
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Category -f mappings/category.mapping.json -r true
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Page -f mappings/page.mapping.json
(ve)$ eg-tools resync -c development.ini -m unicore.content.models.Localisation -f mappings/localisation.mapping.json

Running Unicore CMS tests
-------------------------

.. code-block:: bash

(ve)$ pip install -r requirements-dev.txt
(ve)$ py.test cms


.. _Pyramid: http://docs.pylonsproject.org/en/latest/docs/pyramid.html
.. _Brew: http://brew.sh


CHANGELOG
=========
1.10.1
------
- Add endpoint for retreiving repo names

1.10.0
------
- Add marathon version info to health check

1.9.8
-----
- Fix parsing of result_per_page configuration option (it's passed in as a
string and needed to be parsed into an integer).

1.9.7
-----
- Fix bug that prevented the results_per_page configuration option
from having an effect on the number of pages displayed in a
category listing.

1.9.6
-----
- Add pagination to category listings

1.9.5
-----
- use latest version of elastic-git (pins elasticsearch==1.7.0)

1.9.4
-----
- Exclude health checks from GA analytics

1.9.3
-----
- Add uswgi to dependencies

1.9.0
-----
- Support remote repos via unicore.distribute.
- Remove auto-cloning of repo on startup.

1.8.1
-----
- Add fallbacks for unsupported languages
- Ensure GA Titles are specified for static pages

1.8.0
-----
- Add comments using unicore.comments.client
- Handle non-existent category in page and category views
- Add page/category title context to GA

1.7.1
-----
- pin cornice to 1.0.0

1.7.0
-----
- Add auth using unicore.hub.client
- pin cornice to 0.18.1

1.6.6
-----
- Remove cornice version pinning

1.6.5
-----
- Consistently convert ES objects to `elastic-git` model objects

1.6.4
-----
- Add localised logo support

1.6.3
-----
- Ensure detail page doesn't break for flat pages

1.6.2
-----
- Use latest changes of EG (Changes to Avro schema)

1.6.1
-----
- provide es host in fastforward

1.6.0
-----
- Add branded 404 page
- Allow reading of `es.host` from config

1.5.2
-----
- Refactor Search templates

1.5.1
-----
- Ensure list of languages in change page is sorted

1.5.0
-----
- Change language selector to allow featured languages

1.4.2
-----
- Allow querystring-less locale url

1.4.1
-----
- Fix tests breaking because of latest elasticsearch

1.4.0
-----
- Add support for Google Analytics tracking
- Add backend support for search.

1.3.1
-----
- Ensure localisation is fastforwarded

1.3.0
-----
- Add localisation support to schema

1.2.2
-----
- Change order of get_image_url params

1.2.1
-----
- Use `image_host` from json

1.2.0
-----
- Add image support to view

1.1.1
-----
- Use custom locale negotiator

1.1.0
-----
- Added image field to model
- Add fallback for Swahili and English UK

1.0.13
-----
- Use not_analyzed for language field

1.0.12
-----
- Ensure `get_page` returns None instead of 404

1.0.11
-----
- Ensure sensible default for ordering pages (default: position)

1.0.10
-----
- Ensure featured pages in category on homepage are ordered by position (ascending)

1.0.9
-----
- Ensure featured pages in category on homepage are ordered by position

1.0.8
-----
- Autodeployment with travis - attempt 2

1.0.7
-----
- Autodeployment with travis - attempt 1

1.0.6
-----
- Enforce ordering for pages and categories using `position`

1.0.5
-----
- Added date formatting helper

0.6.3
-----
- Redirect to homepage after changing language

0.6.2
-----

- Better wrapper around repos & workspaces to make moving away from
pygit2 easier.

0.6.1
-----

- Fix for workspace caching

0.6.0
-----

- Cache workspace to reduce number of open files

0.5.0
-----

- Views now return actual objects instead of dictionaries
to the template contexts.

0.4.3
-----
- Fixed bug when filtering multiple language pages by slug

0.4.2
-----
- Pages now render markdown

0.4.1
-----
- Change default cache duration to 10mins

0.4.0
-----
- Allow content to be featured on homepage

0.3.2
-----
- Ensure setting locale always redirects

0.3.1
-----
- Fix error when checking language for cached category/page

0.3.0
-----
- Allow content to be filtered by language selection

0.2.8
-----
- Add support for flat pages

0.2.7
-----
- Add caching to `get_featured_category_pages`

0.2.6
-----
- Added sensible default for available_languages

0.2.5
-----
- Added support for translations

0.2.4
-----
- Allow top nav to be global variable

0.2.2
-----
- Use `utils.get_workspace()` to avoid duplication

0.2.2
-----
- Fix development.ini file

0.2.1
-----
- Bump required version for praekelt-python-gitmodel

0.2
---
- Added `git.content_repo_url` for cloning when app starts

0.1
---
- Initial version

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unicore-cms-1.10.1.tar.gz (195.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page