Installer Risefor sur votre site

Risefor est un outil open-source, installez le sur votre site, mettez votre logo et couleurs et profitez de toutes les fonctionnalités !

Installer Risefor vous même

Téléchargez le fichier, installez le et c'est parti !

Télécharger risefor

ATTENTION : Une mise à jour approche
(voir les détails)

Faite appel à un.e développeur.euse !

Des développeurs.euses indépendant.e.s sont disponible pour réaliser l'installation. Un devis indicatif vous sera fourni, le paiement se fera en conscience.

Appel à un.e ami.e

Comment installer Risefor ?

  1. Télécharger le fichier et placer où vous souhaitez que l'application soit installée
  2. Ouvrez votre terminal
    Si vous installez directement sur un site web, accédez à ce dernier en ssh
  3. Tapez "./install.sh" pour exécuter le fichier d'installation. Vous verrez votre terminal exécuter des commandes. Ces dernières sont en train d'installer les fichiers de Risefor ainsi que les applications nécessaire au bon fonctionnement de l'application
  4. Tapez "python3 manage.py createsuperuser" : Le terminal vous demandera une adresse email et un mot de passe afin de vous créer un compte pour administrer la plateforme
  5. Tapez "python3 manage.py runserver" pour lancer le serveur. Si vous avez téléchergez l'application sur votre ordinateur, tapez "http://127.0.0.1:8000/" dans votre navigateur pour voir l'application
    Attention : Assurez vous d'être dans votre environnement virtuel. Celà est visible via un (env) présent au début de votre ligne de commande.
    Si ce n'est pas le cas, tapez la commande suivante : ". env/bin/activate # optional venv"

Toutes les informations sont disponible sur le compte git

Questions fréquentes

Installation et la personnalisation de la plateforme

Quels sont les configurations serveur ?

Voici un exemple issue d'un site en production :

  1. Type : Python WSGI
  2. Default path : votre-dossier/production/united4earth/wsgi.py
  3. Working directory : /united4earth/production/
  4. Python version : 3.6.7
  5. Static paths : /static/=/votre-dossier/production/united4earth/staticfiles/

Comment mettre mon logo ?

  1. Placez votre logo dans le fichier des images disponible ici :
    /united4earth/static/img/
  2. Ouvrez le fichier "header.html" disponible ici :
    /united4earth/templates/united4earth/header.html
  3. Allez à la ligne 10 du fichers et remplacer "logo_beta_gros.png" par le nom de votre logo

Comment changer les couleurs du site ?

Les fichiers de style sont disponible dans le dossier suivant :
united4earth/static/scss/

Au sein de ce dossier vous trouverez différents fichiers correspondant au sections du site.
Vous pouvez apportez les modificatitions globales des couleurs au sein des fichiers _global.scss et _mixins.scss

Comment mettre à jour les couleurs et autres styles ?

Afin de mettre à jours les fichiers de style (css) vous devez compilez les fichez "scss". Pour ce faire tapez la commande suivante :
sass united4earth/static/scss/index.scss united4earth/static/css/united4earth.css

Si vous avez apportez des modifications sur la carte, tapez :
sass united4earth/static/scss/risefor-map.scss united4earth/static/css/risefor-map.css

Comment charger moins d'élus pour la version de développement ?

Afin de rendre la version de développement plus légère vous avez la capacité à charger qu'une partie des élu.e.s. Pour ce faire, ajoutez "--dev" à la fin de la commande suivante python3 manage.py import_elected lors de l'installation.

ATTENTION : Si vous avez déjà chargé toute la base d'élu.e.s vous devrez les supprimer via l'interphase admin.

Commande entière : python3 manage.py import_elected --dev
Cette commande chargera 10 élu.e.s à la fois.

Est-ce que je peux ajouter des fonctionnalités ?

Biensur ! Le concept de Risefor est d'évoluer en fonction des besoins de ses utilisateurs.trices. Nous avons créé un groupe dédié permettant d'échanger sur le sujet, venez la proposer !

Est-ce que je peux enlever des fonctionnalités ?

Sans soucis ! Retirez les sections qui ne vous sont pas utile, l'outil est fait pour ! :)

Première utilisation

Comment accéder à l'interphase d'administration

Par default pour accéder à l'interphase d'administration vous n'avez qu'à ajoutez "/admin" après le nom de domaine.
Connectez vous avec le compte créé à l'étape 5 de l'installation.

Exemple : exemple.com/admin

Je n'ai pas de thème, de fréquence ou de type d'organisations proposé dans mes formulaires

Vous devez créer les choix qui seront disponible au sein de la plateforme d'administration. Accédez y en ajoutant "/admin" à la fin de votre url.
Une fois connectez, ajoutez des choix au sein des sections "thème d'actions", "fréquence" et "Type d'organisations"

Quand j'installe l'outil la carte des actions est grise

La carte reste grisé tant qu'il n'y a pas d'actions. Créez une action, avec une adresse, et la carte se mettra à jour

Erreur "AllowHost"

Si vous avez installé Risefor sur un site et recevez cette erreur

  1. Ouvrez le fichier settings.py dans le dossier united4earth
  2. Cherchez le terme "ALLOWED_HOSTS"
  3. Ajoutez votre nom de domaine au sein des crochet

Exemple : ALLOWED_HOSTS = ['mon-domaine.org']

Autres questions

Comment déployer mon site local ?

Vous avez un fichier "deploy.sh" présent à la racine de l'application.
Au sein de se fichier remplacez la ligne u4e@ssh-u4e.happy-dev.fr par vos identifiant de ssh puis appelez ce fichier.
ATTENTION : Assurez vous d'être bien connectez à vore dépot git ! (vim .git/config)

Exemple : ./deploy.sh staging -> Déploie la commande sur le domaine correspondant à "staging"

Comment apporter les mises à jours de l'application ?

Une fois que nous avons fini une fonctionnalité, ou une amélioration, nous la mettons en ligne sur la branche "master" du compte git.
Vous pouvez télécharger les modifications en réalisant la commande ci-dessous depuis la racine du dossier de l'application

git pull origin master

Vous n'avez pas trouvé votre réponse ?

Envoyez un email à l'équipe technique, ou ouvrez un ticket sur git, et nous ferons au mieux pour vous aider