Skip to main content
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

Release files for unicore-cms 1.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unicore-cms 1.10.1
File Size Uploaded
unicore-cms-1.10.1.tar.gz 195.0 kB Details

Release files / unicore-cms-1.10.1.tar.gz

Download URL unicore-cms-1.10.1.tar.gz
Size 195.0 kB
Tags Source
SHA-256 checksum
How to use checksums
b1a8e0aa9f7a108814dd8c447e17a70d6d9ec724b75dc524f90deec1e277f222
BLAKE2b-256 checksum
How to use checksums
57c64c5a6aa0d3604c2f9f30c4f22b46baed5caf3a37e00f923dffa4de7bca44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.10.1 This release

1 release file

1.10.0

1 release file

1.9.8

1 release file

1.9.7

1 release file

1.9.6

1 release file

1.9.5

1 release file

1.9.3

1 release file

1.9.2

1 release file

1.9.1

1 release file

1.9.0

1 release file

1.8.2

1 release file

1.8.1

1 release file

1.8.0

1 release file

1.7.1

1 release file

1.7.0

1 release file

1.6.6

1 release file

1.6.5

1 release file

1.6.4

1 release file

1.6.3

1 release file

1.6.2

1 release file

1.6.1

1 release file

1.6.0

1 release file

1.5.2

1 release file

1.5.1

1 release file

1.5.0

1 release file

1.4.5

1 release file

1.4.4

1 release file

1.4.3

1 release file

1.4.2

1 release file

1.4.1

1 release file

1.4.0

1 release file

1.3.1

1 release file

1.3.0

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2.0

1 release file

1.1.1

1 release file

1.1.0

1 release file

1.0.13

1 release file

1.0.12

1 release file

1.0.11

1 release file

1.0.10

1 release file

1.0.9

1 release file

1.0.8

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0.0

1 release file

0.6.4

1 release file

0.6.3

1 release file

0.6.2

1 release file

0.6.1

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.1

1 release file

0.3.0

1 release file

0.2.8

1 release file

0.2.5

1 release file

0.2.4

1 release file

0.2.3

1 release file

0.2.1

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page