WeddingUploader App

Heroku - Django - S3

A simple upload app for wedding photos.

Features

Preview and upload photos directly to S3.
Approve or not the photos uploaded by the guests.
Like pictures and sort them.
Latest Python 3.6 runtime environment and Django 2.

How to Use

To run in your local machine, follow these steps:

Clone the repository or download the zip.
Create your working environment. $ python3 -m venv /path/to/venv
Install the requirements. ((venv)$ pip install -r requirements.txt)
Set your environment variables (ex: $ export AWS_ACCESS_KEY_ID:xxx) for the S3 bucket or put them on: '../WeddingUpload/weddingupload/settings.py'

   AWS_ACCESS_KEY_ID = os.environ.get('AWS_ACCESS_KEY_ID', '')
   AWS_SECRET_ACCESS_KEY = os.environ.get('AWS_SECRET_ACCESS_KEY', '')
   AWS_STORAGE_BUCKET_NAME = os.environ.get('S3_BUCKET_NAME', '')

(replace with your credentials where the '' are)

(for your safety, never, never commit your secret credential to any public repository)

Run(venv)$ python manage.py collectstatic for sending the static files to S3.
Run(venv)$ python manage.py migrate and (venv)$ python manage.py makemigrations to create the models in the DB
Finally run(venv)$ python manage.py runserver If everything went well you should see something like this:

Performing system checks...

System check identified no issues (0 silenced).
January 15, 2019 - 23:01:12
Django version 2.1.5, using settings 'weddingupload.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Create a superuser and enter the Django admin to approve and publish the uploaded photos.

Screenshots

Deployment to Heroku

This project is ready to run in Heroku.

Export the S3 credentials to Heroku variables with the CLI or the web platform. Ex: $ heroku config:set GITHUB_USERNAME=joesmith

$ git init
$ git add -A
$ git commit -m "Initial commit"

$ heroku create
$ git push heroku master

and follow similar steps as above from step 4 but in Heroku's server. (requirements are installed with pipfile.lock automatically when you push) Ex: $ heroku run python manage.py migrate

License: MIT

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Feedback and improvements to the project are extremely welcome. =)

(All the images used are labeled for reuse with modification)