Andaal Readme

La culture pour le developpement.

Environment Variables

To run this project, you will need to add the following environment variables to your .env file

Use .env_prod for production and .env_dev for local

If your website have ssl (https):

PAYPAL_CALLBACK_HTTPS = True\

EXCHANGE_RATE_API_KEY = YOUR-API-KEY for fetching XAF rate with respect to EURO. \

REFRESH_XAF_RATE_AFTER_SEC = Time Gap in seconds for fetching the XAF rate with respect to EURO. \

SMS_AUTH_SCRETE_KEY = YOUR-API-KEY for sending SMS \

SMS_SENDER_PHONE_NUMBER = YOUR-Mobile-Phone-Number for sending SMS \

EMAIL_HOST = Your Email host: smtp.gmail.com if you are using Gmail \

EMAIL_USE_TLS = True all modern day email support EMAIL_USE_TLS \

EMAIL_PORT Your Email PORT

EMAIL_HOST_USER Your Email address

EMAIL_HOST_PASSWORD Your Email App Pass

Run Locally

Clone the project

  git clone https://github.com/ayyaninam/fred-proj1-ANDAAL

Go to the project directory

  cd fred-proj1-ANDAAL

New Virtual Environment

  python3 -m venv env

Active Virtual Environment

Mac/Linux:

  source env/bin/activate

Windows:

  env\Scripts\bin\activate

Install dependencies

  pip install -r requirements.txt

Clear the Media Cache (For New Generation)

  python manage.py thumbnail clear_delete_referenced

Make Migrations

  python3 manage.py makemigrations

Migrate

  python3 manage.py migrate

Base Make Migrations

  python3 manage.py makemigrations base

Base Migrate

  python3 manage.py migrate base

Collect Static

  python3 manage.py collectstatic

Collect Static

  python3 manage.py runserver

Migrate from SQLITE to PSQL

Breif description on how to migrate the data from sqlite to PSQL

Prefer for only Production

Step 1: Install the PSQL \ Step 2: Install the requirements.txt

pip install -r requirements.txt

Step 3: Dump all the Data \ Or you can grab the data.json file from the proj directory. \ I already created that.\ Please Run this command in project directory to create data.json file.

python3 manage.py dumpdata --all > data.json

Step 4: Create DB Schema.

python3 manage.py sqlflush > schema.sql

Step 5: Launch the PSQL

Step 6: Create the DB (with your prefer pass and name) \

Step 7: Run this command to load the Schema in your database.

\i PATH_TO_schema.sql

Step 8: Go to the .env_prod or .env_dev and change the DB extensions accordingly.

pip install -r requirements.txt

Note:

\i PATH_TO_schema.sql

If this command make some problem.\ Then Go to the project .env and change the DB extension to connect to PSQL.\ After that, run:

python3 manage.py migrate

Then Repeat the Step 7 and Step 8.

python3 manage.py loaddata data.json

Static Files (if you aren't use NGINX in Production)

python3 manage.py collectstatic

This will push all your Static files in new Folder.\ Then whitenoise will take care of all the Static Files.\ Delete or Comment this line:

whitenoise.runserver_nostatic

and this line:

whitenoise.middleware.WhiteNoiseMiddleware

Currently at: line no: 30 and 102 in settings.py\ If you want NGINX to take care of Static files.

SQLITE to PSQL

Install Postgres on your computer.

First install

sudo apt-get install libpq-dev python-dev

which are Postgres dependencies to work with Django perfectly.

Then, enter

sudo apt-get install postgresql postgresql-contrib

command to install Postgres.

Access to Postgres using

sudo su - postgres

command.

Create a new database.

createdb <dbname>

Create a database user (with password).

createuser -P <username>

Access the shell using psql command.

Grant this new user access to your new database with

GRANT ALL PRIVILEGES ON DATABASE <dbname> TO <username>

command.

Dump existing data. Make sure you are connected with your previous Database.

python3 manage.py dumpdata > datadump.json

Install Postgres package.

pip install psycopg2

Change settings.py configuration to the following:

DATABASES = {
 'default': {
     'ENGINE': 'django.db.backends.postgresql_psycopg2',
     'NAME': '<dbname>',
     'USER': '<username>',
     'PASSWORD': '<password>',
     'HOST': 'localhost',
     'PORT': '',  
 }
}

Make sure you can connect to Postgres DB.

python3 manage.py migrate --run-syncdb

Run this on Django shell to exclude contentype data.

python3 manage.py shell

>>> from django.contrib.contenttypes.models import ContentType
>>> ContentType.objects.all().delete()
>>> quit()

Finally, load your data.

python3 manage.py loaddata datadump.json

Migrate To Internalization (Personal Note!)

python manage.py update_translation_fields APP_NAME MODEL_NAME