Skip to content

Latest commit

 

History

History
88 lines (67 loc) · 4.28 KB

README.md

File metadata and controls

88 lines (67 loc) · 4.28 KB
Raw

SmartGallery: A Django-based Image Gallery

SmartGallery is a versatile image gallery project developed using the Django framework (Python). This project empowers you to:

  • Create and manage albums
  • Upload images and associate them with YouTube video links
  • Modify albums and images (reorder, sort, adjust columns)
  • Configure album visibility settings
  • Choose between grid or masonry gallery views
  • Process uploaded images (generate thumbnails and full-size images for lightbox galleries) by adjusting resolution and quality
  • Customize the menu (reorder and rename items)
  • Incorporate social media links with Font Awesome icons, allowing you to edit their order, labels, and icons
  • Extract EXIF data from images and display it in the lightbox view
  • Access GEO information and coordinates, viewable on Google Maps
  • Edit site settings, including logo upload, meta data configuration, and font styling for captions and footer text
  • Edit EXIF data directly
  • Explore a timeline view (masonry layout) presenting all site images, organized and titled by the year they were taken
  • Translate the admin section of the site; currently supports English and Russian languages, with the option to change this in the General Settings of the Site Settings section
  • Benefit from a template editor equipped with syntax highlighting (HTML, CSS, JS) for the Main (index) and About Me pages, powered by CodeMirror
  • Leverage Django's built-in and custom tags with filters within the Template Editor

Setup and Configuration

To utilize Django, the project requires a SECRET_KEY for security. The following methods are employed to obtain this key:

  1. Retrieve it from the operating system's environment variables using the key: SECRET_KEY
  2. Obtain it from a .env file located near the settings.py file, using the format secret_prod = 'Your key'
  3. Fall back to the default value specified in settings.py

To generate a secret key, you can use tools like djecrety.ir or miniwebtool.com.

Deployment Options

You can initiate the use of this project through either docker-compose or manual setup involving systemd, Gunicorn, NGINX, and Certbot. For manual setup, follow these steps:

  1. Clone the repository: git clone https://github.com/endlessnights/photogallery.git

  2. Navigate to the photogallery directory and create a virtual environment: python3 -m venv venv

  3. Activate the virtual environment: source venv/bin/activate

  4. Update pip and install requirements: pip install --upgrade pip, pip install -r core/requirements.txt

  5. Generate an SQLite database with tables: python manage.py makemigrations smartgallery, followed by python manage.py migrate

  6. If you're starting with Docker or manual setup, Django will automatically create a demo user. Remember to change the default username, password, and email:

    • Login: root
    • Password: RootPassword

  7. NGINX Configuration:

Example of NGINX configuration 
server {
    server_name endlessnights.ru;

    location = /favicon.ico { access_log off; log_not_found off; }
    
    location /static/ {
        root /var/www/smartgallery/core;           # Path to the static directory
    }
    
    location /media/ {
        root /var/www/smartgallery/core;           # Path to the media directory
    }
    
    location / {
        include proxy_params;
        proxy_pass http://unix:/run/smartgallery.sock;
    }
    
    client_max_body_size 300M;
    proxy_read_timeout 300;
    proxy_connect_timeout 300;
    proxy_send_timeout 300;
}

Support the developer on Patreon.

Screenshots

Some screenshots:

image image image image