Revision d26f765d

b/docs/source/index.rst
40 40

  
41 41
Although not required it is recommended to use `snf-webproject`_ to deploy the
42 42
cms application. If you want to deploy using your custom django project take
43
a look on `cloudcms/synnefo_settings.py`_ file which includes ``snf-webproject`` 
43
a look on `cloudcms/synnefo_settings.py`_ file which includes `snf-webproject`
44 44
hooks to find which django settings are required for cms to work.
45 45

  
46 46
.. _snf-webproject: http://docs.dev.grnet.gr/snf-webproject
......
115 115
the above command on ``http://<deployment-domain>/cmsmanage/`` url and start
116 116
editing the content of your cms.
117 117

  
118
.. note::
119
    If you want snf-webproject to server django admin files set 
120
    ``ADMIN_MEDIA_PREFIX=/static/admin_media`` in your settings and link
121
    django admin media directory (/usr/share/pyshared/django/contrib/admin/media/) 
122
    as /usr/share/synnefo/static/admin_media.
118

  
119
Static files
120
************
121

  
122
snf-cloudcms requires the following static files to be served by your django
123
project:
124

  
125
    * feincms static files for the admin interface
126
    * django.contrib.admin static files
127
    * snf-cloudcms static files
128

  
129
If you are using `snf-webproject`_ to deploy your cms all static file handlers
130
should be taken care for you and no additional steps required in the deployment
131
process. This automatic behaviour can be enabled/disabled from the 
132
``WEBPROJECT_SERVE_STATIC`` setting.
133

  
134
If you want to disable serving static files from your django project, set
135
``WEBPROJECT_SERVE_STATIC`` to False in your settings and configure your 
136
web server to serve static files of the following locations to the specific 
137
urls which can be altered in your settings files:
138

  
139
* <feincms install dir>/feincms/static/ -> FEINCMS_ADMIN_MEDIA (default:/static/feincms/)
140
* <django install dir>/django/contrib/admin/media/ -> ADMIN_MEDIA_PREFIX (default:/static/djangoadminmedia/)
141
* <cloudcms install dir>/cloudcms/static/ -> MEDIA_URL (default:/static/)
142

  
143

  
144
CMS uploads
145
***********
146

  
147
snf-cloudcms uses feincms medialibrary application to store and display
148
files in cms pages. The location of those files is based on MEDIA_ROOT setting
149
and is calculated using the following expression::
150

  
151
    MEDIA_ROOT + '/medialibrary/'
152

  
153
if you deploy using `snf-webproject`_ this defaults to 
154
``/usr/share/synnefo/static/medialibrary`` which you should create and grant
155
appropriate permissions for web app to be able to access it. e.g. if you deploy
156
using nginx/gunicorn and your gunicorn workers run with www-data user 
157
permissions::
158

  
159
    mkdir /usr/share/synnefo/static/medialibrary
160
    chown www-data:www-data /usr/share/synnefo/static/medialibrary
161
    chmod o+rw /usr/share/synnefo/sattic/medialibrary
123 162

  
124 163

  
125 164
Indices and tables

Also available in: Unified diff