Getting Started¶
Installation¶
To install onespacemedia-cms simply run:
$ pip install onespacemedia-cms
If you want the ability to invite users via the admin, then run:
$ pip install onespacemedia-cms[usertools]
Once the project has been installed, you can create a project with the following command:
$ start_cms_project.py project_name .
Where project_name
is the name of your project and .
is the current directory (this will cause the manage.py
to be created in your working directory, rather than in a subfolder.
You should now run the following:
$ ./manage.py migrate
$ ./manage.py createsuperuser
Configuration¶
start_cms_project.py
takes care of a lot of the settings automatically, but it’s worth taking a look through the settings/base.py
and updating any settings which still require values, the key ones being:
SITE_NAME
SITE_DOMAIN
EMAIL_HOST
/EMAIL_HOST_USER
/EMAIL_HOST_PASSWORD
ADMINS
WHITELISTED_DOMAINS
To configure the various third-party integrations, you will need to generate API keys on each of the platforms and add them to the base settings file.
Google+ Authentication API¶
- Log in to the Google Developers Console.
- Click “Create Project”.
- Enter your Project Name.
- (optional) Click “Show advanced options..” and change the data center location.
- Click “Create”.
- Click APIs & auth -> Consent screen.
- Select your Email Address.
- Enter your Product Name.
- Click “Save”.
- Click APIs & auth -> APIs
- Enable the “Google+ API”.
- Click APIs & auth -> Credentials
- Click “Create new Client ID”
- Enter your domain name into the “Authorized Javascript Origins” textarea.
- Click “Create Client ID”.
- Copy the “Client ID” to the setting named
SOCIAL_AUTH_GOOGLE_PLUS_KEY
. - Copy the “Client Secret” to the setting named
SOCIAL_AUTH_GOOGLE_PLUS_SECRET
.
Adobe Creative SDK¶
- Log in to the Adobe website.
- Click “New Application”.
- Enter your application name.
- Select “Web”.
- Enter a description.
- Fill out the CAPTCHA.
- Click “Add Application”.
- Copy the secret key to
ADOBE_CREATIVE_SDK_CLIENT_SECRET
. - Copy the API key to
ADOBE_CREATIVE_SDK_CLIENT_ID
. - Set
ADOBE_CREATIVE_SDK_CLIENT_ID
toTrue
.