Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/henry-jacq/photogram-mongodb
Photo Sharing Platform!
https://github.com/henry-jacq/photogram-mongodb
bootstrap grunt jquery mongodb php sass
Last synced: about 1 month ago
JSON representation
Photo Sharing Platform!
- Host: GitHub
- URL: https://github.com/henry-jacq/photogram-mongodb
- Owner: henry-jacq
- Created: 2023-12-30T11:27:49.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-03T07:51:45.000Z (8 months ago)
- Last Synced: 2024-09-15T10:16:33.915Z (4 months ago)
- Topics: bootstrap, grunt, jquery, mongodb, php, sass
- Language: PHP
- Homepage:
- Size: 14 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Photogram
Photogram is an easy-to-use web app for sharing photos with a clean and uncluttered interface.
It is designed to facilitate photo-sharing among users. Its sleek and intuitive interface, combined with powerful back-end functionality, makes it the ideal platform for sharing photos with friends, family, and colleagues. This document will provide detailed instructions on how to install and run the project, so that you can start sharing your favorite photos today.
> **NOTE:** *This project is currently under development and some things might not work as expected.*
## Table of Contents
- Getting Started
- Prerequisites
- Installation
- Usage
- Contributing
## Getting Started
### Prerequisites
Before starting the project, you will need to have the following packages installed on your machine:
- PHP (v8.0 above)
- NPM
- Curl
- Composer
- Apache (Web Server)
- Grunt (Task Runner)
### Installation
To setup photogram, follow these steps:
Install composer dependencies:
```bash
composer update
```
Install NPM dependencies:
```bash
npm install
```
Install Grunt and Sass:
```bash
npm install -g grunt-cli sass
```
Install php-gd and php-zup extension:
- php-gd is used for image processing
- php-zip is used for zipping files
```bash
sudo apt-get install php-gd php-zip php-mongodb php-cli php-json php-mbstring php-xml php-pcov php-xdebug certbot python3-certbot-apache
```
Install PHPUnit
```
wget -O phpunit.phar https://phar.phpunit.de/phpunit-10.phar
chmod +x phpunit.phar
sudo mv phpunit.phar /usr/local/bin/phpunit
```
Uncomment the gd and mongodb extension in php.ini config:
```php
;extension=gd
;extension=mongodb
extension=gd
extension=mongodb
```
Enabling apache modules:
```bash
sudo a2enmod headers
sudo a2enmod rewrite
sudo a2enmod actions
sudo a2enmod expires
sudo a2enmod deflate
sudo a2enmod socache_shmcb
sudo a2enmod ssl
```
Generate SSL certificate
```bash
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/photogram.key -out /etc/ssl/certs/photogram.crt
```
Add apache vhost:
```bash
sudo touch /etc/apache2/sites-available/photogram.conf
```
- Then paste the following snippet into photogram.conf
- Replace the path with your project's path
- Photogram HTTP Vhost Config
```apache
ServerAdmin webmaster@localhost
DocumentRoot /home/user/htdocs/photogram/public
ServerName photogram.local
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css application/javascript application/json application/xml image/svg+xml
ExpiresActive On
ExpiresByType image/jpg "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType image/gif "access plus 1 year"
ServerSignature Off
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
```
- Photogram HTTPS Vhost Config
```apache
ServerAdmin webmaster@localhost
DocumentRoot /home/user/htdocs/photogram/public
ServerName photogram.local
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
SSLEngine on
SSLCertificateFile /etc/ssl/certs/photogram.crt
SSLCertificateKeyFile /etc/ssl/private/photogram.key
SSLOptions +StdEnvVars
SSLOptions +StdEnvVars
BrowserMatch "MSIE [2-6]" nokeepalive ssl-unclean-shutdown downgrade-1.0 force-response-1.0
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css application/javascript application/json application/xml image/svg+xml
ExpiresActive On
ExpiresByType image/jpg "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType image/gif "access plus 1 year"
ServerSignature Off
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
```
Restart apache to apply changes
```bash
sudo service apache2 restart
```
To find out which user as apache web server running? Run this command.
```bash
ps aux | egrep '(apache|httpd)' | awk '{print $1}' | uniq -d
```
Create and change folder permissions:
- This is to allow apache to move uploaded files to this folder.
- If the user is not the same as below, you can replace www:data user with the user that is currently running Apache.
```bash
mkdir -p storage/posts/ storage/avatars/
sudo chown -R www-data:www-data storage/
sudo chmod -R 755 storage/
sudo usermod -aG www-data
```
## Usage
The Photogram application has an intuitive and user-friendly interface that makes it easy to share your photos with others. Once you've logged in to your account, simply click on the upload button and select the images you wish to share. It will guide you through the process of uploading your photos and adding relevant descriptions.
Once your photos are uploaded, they will be visible to other users on the platform. You can browse and search through existing content, and interact with other users by liking and commenting on their photos.
Overall, Photogram is a powerful yet simple-to-use platform that makes it easy to share your visual creations. Whether you're a professional photographer or just someone who loves to capture and share moments with others, Photogram is the perfect platform for you.
## Contributing
We welcome contributions to the Photogram project! Here are some ways you can get involved:
- Report bugs and suggest new features by creating an issue on our [git repository](https://git.selfmade.ninja/Henry/photogram/-/issues).
- Contribute code by forking the repository, making changes, and submitting a pull request.
- Help improve the documentation by submitting a pull request with your changes.
Thank you for your interest in contributing to Photogram!