Page Comparison

...

1. You will need to be in your virtual environment
   source <<virtualenv_location>>/bin/activate
2. Navigate to your project's folder
   $ cd <<django_project_location>>
3. Install NearBeach through PIP. This will install NearBeach as well as all the required libraries utilised by NearBeach.
   pip install NearBeach
4. Edit the project's settings.py to include NearBeach
   $ nano ./<<project name>>/settings.py
   Add the following line to the "INSTALLED_APPS" section
   'NearBeach.apps.NearBeachConfig',
   'django.contrib.humanize',
   'tinymce',
   'django_select2',
   
   
   Now save the document
5. Enabling reCAPTCHA (optional). Register an account at [Google reCAPTCHA](https://www.google.com/recaptcha/intro/invisible.html).
   $ nano ./<<project name>>/settings.py
   The following variables will need to be placed into your settings.py.
   RECAPTCHA_PUBLIC_KEY = 'Your public key'
   RECAPTCHA_PRIVATE_KEY = 'Your private key'
   
   
6. Security - Add the following lines of code into the settings.py
   SECURE_SSL_REDIRECT = True
   SESSION_COOKIE_SECURE = True
   CSRF_COOKIE_SECURE = True
   CSRF_HTTPONLY = True
   
   
7. Email - optional however required for resetting passwords
   

   $ nano ./<<project name>>/settings.py
   Add the following lines of code into the settings.py
   EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
   EMAIL_USE_TLS = True
   EMAIL_HOST = '<< your email host >>'
   EMAIL_PORT = 25
   EMAIL_HOST_USER = '<< your username >>'
   EMAIL_HOST_PASSWORD = '<< your password >>'
   DEFAULT_FROM_EMAIL = EMAIL_HOST_USER

8. Private Documents

   nano ./<<project name>>/settings.py

   Add the following lines of code into the settings.py

   PRIVATE_MEDIA_URL = '/private/' #Can change
   if DEBUG:
       # dev
       import os

       PROJECT_PATH = os.path.abspath(os.path.dirname(__file__))
       PRIVATE_MEDIA_ROOT = os.path.join(PROJECT_PATH, 'private')
       PRIVATE_MEDIA_SERVER = 'DefaultServer'
   else:
       # prod
       PRIVATE_MEDIA_ROOT = '<< private documents location >>'
       PRIVATE_MEDIA_SERVER = 'ApacheXSendfileServer'

   The following redundant code will need to be used at the moment.

   STATIC_URL = '/static/'
   STATIC_ROOT= os.path.join(BASE_DIR,'static/')
   MEDIA_URL = '/media/'
   MEDIA_ROOT = os.path.join(BASE_DIR,'media/')

9. Edit the project's URL.py to include NearBeach

   nano ./<<project name>>/url.py

   Please make sure that the following import in included at the top of the file
   from django.urls import path, include
   
   Either of the following can be entered into the "urlpatterns" section

   path('', include('NearBeach.urls')),
   path('tinymce/', include('tinymce.urls')),
   path('select2/', include('django_select2.urls')),
   

10. Create Database/Migrations
    The database will need to be setup. Please note by default Django uses sqlite3, however it is possible to setup NearBeach to use a mysql database.

    python ./manage.py migrate
    python ./manage.py migrate NearBeach

    If you have setup NearBeach with an SQLite database, you will need to change it's permissions so nginx can access it
    sudo chmod 7777 ./db.sqlite

11. Create superuser
    A superuser will need to be created. This superuser will be able to enter the ADMIN site of Django, which from there will be able to do administration items.

    python ./manage.py createsuperuser

    Enter in the correct details for the superuser

    
    

12. Collect the static

    The website uses static images, javascript, and CSS. You will need to collect this data to the static folder (set in the settings.py). Please run the following command

    python ./manage.py collectstatic

    
    

13. Create the private media folder
    $ mkdir ./private_media/

14. Assign write permissions to the ./media/ and ./private_media/ folder
    $ sudo chmod -R 777 ./media
    $ sudo chmod -R 777 ./private_media

15. Restart gunicorn
    $ sudo service gunicorn restart

...