Abre’s Community Edition is built on a LAMP stack. For coding an app, you will want to develop on a local machine. While there are a number of ways you can set up an environment, we typically recommend MAMP or WAMP for appathons. This part covers the basics of setting up a local environment (with links to more detailed how-tos).
Create an OAuth Project in Google
Abre does not create its own usernames and passwords. Instead, users authenticate with Google or Microsoft. For this example we’re using Google. You will need to create an OAuth project for authentication to work.
View Google’s Documentation on how to set up OAuth 2.0: Setting up OAuth 2.0 – Google Cloud Platform Console Help
Change your Configuration File
- Navigate to the configuration.php file.
- Open with your preferred editor.
- Add Google Client ID (around line 58)
- Add Google Console Seccret
- Add Google Console API Key
Make Sure MAMP is Running
Note: If you are unsure if MAMP is running, go to your MAMP folder and run the file named MAMP. This will bring up a window showing you the status of your apache and mysql servers. Ensure both boxes are green and continue.
Launch CE Abre on Localhost
- Select the “Open start page” options from the MAMP window or navigate to http://localhost/MAMP.
- Under the MYSQL section select “phpmyadmin”.
- Once you are redirected, select the “Databases” tab located near the top of the page.
- Enter “Abre” in the database name field and select “create”.
- Next open up an internet browser and navigate to http://localhost/. Here you should see the Abre login screen!
- Go ahead and try logging in by selecting “Sign in as Staff”.
- Then select “Sign in with Google”
You should now be successfully logged in to your local installation of Abre!