gratify-me
说明： 用于跟踪注释、引号和任何基于文本的内容的中心。
(A hub for keeping track of notes, quotes, and anything that is text-based.)
(A hub for keeping track of notes, quotes, and anything that is text-based.)
文件列表:
.browserslistrc (9, 2023-10-13)
.dockerignore (169, 2023-10-13)
.ruby-version (11, 2023-10-13)
Dockerfile (4284, 2023-10-13)
Gemfile (2502, 2023-10-13)
Gemfile.lock (8613, 2023-10-13)
Rakefile (227, 2023-10-13)
app/ (0, 2023-10-13)
app/assets/ (0, 2023-10-13)
app/assets/config/ (0, 2023-10-13)
app/assets/config/manifest.js (63, 2023-10-13)
app/assets/images/ (0, 2023-10-13)
app/assets/images/.keep (0, 2023-10-13)
app/assets/images/project_logo.png (3380, 2023-10-13)
app/assets/stylesheets/ (0, 2023-10-13)
app/assets/stylesheets/application.scss (7242, 2023-10-13)
app/assets/stylesheets/home.scss (176, 2023-10-13)
app/assets/stylesheets/says.scss (176, 2023-10-13)
app/channels/ (0, 2023-10-13)
app/channels/application_cable/ (0, 2023-10-13)
app/channels/application_cable/channel.rb (79, 2023-10-13)
app/channels/application_cable/connection.rb (85, 2023-10-13)
app/controllers/ (0, 2023-10-13)
app/controllers/application_controller.rb (856, 2023-10-13)
app/controllers/concerns/ (0, 2023-10-13)
app/controllers/concerns/.keep (0, 2023-10-13)
app/controllers/home_controller.rb (1073, 2023-10-13)
app/controllers/says_controller.rb (1090, 2023-10-13)
app/controllers/users/ (0, 2023-10-13)
app/controllers/users/callbacks_controller.rb (2077, 2023-10-13)
app/controllers/users/registrations_controller.rb (394, 2023-10-13)
app/helpers/ (0, 2023-10-13)
app/helpers/application_helper.rb (80, 2023-10-13)
app/helpers/home_helper.rb (22, 2023-10-13)
app/helpers/says_helper.rb (22, 2023-10-13)
app/javascript/ (0, 2023-10-13)
app/javascript/channels/ (0, 2023-10-13)
... ...
.dockerignore (169, 2023-10-13)
.ruby-version (11, 2023-10-13)
Dockerfile (4284, 2023-10-13)
Gemfile (2502, 2023-10-13)
Gemfile.lock (8613, 2023-10-13)
Rakefile (227, 2023-10-13)
app/ (0, 2023-10-13)
app/assets/ (0, 2023-10-13)
app/assets/config/ (0, 2023-10-13)
app/assets/config/manifest.js (63, 2023-10-13)
app/assets/images/ (0, 2023-10-13)
app/assets/images/.keep (0, 2023-10-13)
app/assets/images/project_logo.png (3380, 2023-10-13)
app/assets/stylesheets/ (0, 2023-10-13)
app/assets/stylesheets/application.scss (7242, 2023-10-13)
app/assets/stylesheets/home.scss (176, 2023-10-13)
app/assets/stylesheets/says.scss (176, 2023-10-13)
app/channels/ (0, 2023-10-13)
app/channels/application_cable/ (0, 2023-10-13)
app/channels/application_cable/channel.rb (79, 2023-10-13)
app/channels/application_cable/connection.rb (85, 2023-10-13)
app/controllers/ (0, 2023-10-13)
app/controllers/application_controller.rb (856, 2023-10-13)
app/controllers/concerns/ (0, 2023-10-13)
app/controllers/concerns/.keep (0, 2023-10-13)
app/controllers/home_controller.rb (1073, 2023-10-13)
app/controllers/says_controller.rb (1090, 2023-10-13)
app/controllers/users/ (0, 2023-10-13)
app/controllers/users/callbacks_controller.rb (2077, 2023-10-13)
app/controllers/users/registrations_controller.rb (394, 2023-10-13)
app/helpers/ (0, 2023-10-13)
app/helpers/application_helper.rb (80, 2023-10-13)
app/helpers/home_helper.rb (22, 2023-10-13)
app/helpers/says_helper.rb (22, 2023-10-13)
app/javascript/ (0, 2023-10-13)
app/javascript/channels/ (0, 2023-10-13)
... ...
# Project: Gratify Me
_A hub for keeping track of notes, quotes, and anything that is text-based._
## Objectives
This web-app must accomplish the following:
- [x] Login users with social services (providers) such as Google, GitHub & Twitter with the help of Devise and Omniauth.
- [x] Make sure there's only one login created for each email regardless of which provider he/she uses.
- [x] If a user signs in with the same email but with a different provider, automatically sign in with the provider they logged in initially.
- [x] After user signs in, they can add more info about them via the Profile page.
- [x] Ability to add profile photos via Active Storage & Cloudinary and display photos on the page with a focus on the face.
- [x] Users can then add notes, quotes, etc to their feed. Show error when they try to add an empty post.
- [x] Show users' posts on their homepage sorted from the latest.
- [x] Provide users the ability to search words or expressions of the post they created through the Search Form gem.
- [x] Show appropriate flash messages wherever necessary.
- [x] Show sign-up count to logged-out users.
- [x] Build a responsive site using bootstrap.
- [x] When a user manually enters a URL that doesn't exist, redirect them to the homepage with a flash message informing them that the URL doesn't exist.
---
## Required Gems
**This project was built on Ruby version _3.1.2_.**
Following important gems were installed in these versions:
| **Gem Names** | **Gem** | **Version** | **Use** |
| :-----------: | :----------------: | :---------: | :----------------------------------------------: |
| Rails | _'rails'_ | **6.1.7.2** | _Use for executing and rendering web-app_ |
| Postgresql | _'pg'_ | **1.2.3** | _Use postgres as the database for Active Record_ |
| Bootstrap | _'bootstrap-sass'_ | **3.4.1** | _For SCSS Styling_ |
| Devise | _'devise'_ | **4.8.0** | _Flexible authentication solution_ |
| Omniauth | _'omniauth'_ | **2.0.4** | _Authenticate via Social logins_ |
| Cloudinary | _'cloudinary'_ | **1.21.0** | _A cloud service for storing user images_ |
| Simple Form | _'simple_form'_ | **5.1.0** | _Search query through attributes in database_ |
| Pagy | _'pagy'_ | **5.3.1** | _For Pagination_ |
---
## Setting up a PostgreSQL user
If you don't have a user set on postgres, here's how to set new user:
```bash
sudo -u postgres createuser -s [username]
```
To set a password for this user, log in to the PostgreSQL command line client:
```bash
sudo -u postgres psql
```
Enter the following command to set the password:
```bash
\password your_password
```
Enter and confirm the password. Then exit the PostgreSQL client:
```bash
\q
```
---
## Execution
Run the following commands to execute locally:
The following will install required version of ruby (make sure [rvm is installed](https://rvm.io/rvm/install).)
```bash
rvm use 2.7.2
```
```bash
git clone git@github.com:JuzerShakir/gratify-me.git
```
```bash
cd gratify-me
```
```bash
bundle install
```
#### Imp Note:
To successfully create development and test database, you will need to update `config.database.yml` file with correct postgresql username and password.
To edit the it without exposing your credentials, give the following command:
```bash
EDITOR="code --wait" rails credentials:edit
```
_`code` for Visual Studio Code_
_`subl` for sublime_
This will open `credential.yml` file and enter credential as follows in it:
```
database:
username: your_username
password: your_password
```
Hit `ctrl + s` to save and then close the `credential.yml` file from the editor. This will save the credentials. To check if it did save, run the following inside rails console:
```
Rails.application.credentials.dig(:database, :username)
```
```bash
rails db:create
```
To use Social Login services you will need to create apps for each provider you want to use to generate tokens and secret on their respective developer site.
After creating tokens and secrets for each provider, use `credential.yml` file to store the credentials :
```
provider:
id: abcdefg
secret: xxxxx
```
Replace `provider` with provider name such as google, twitter etc and enter your id and secret for respective providers.
The code in the `config/initializers/devise.rb` helps load these credentials for each provider.
To use cloudinary, make a cloudinary account. After creating, visit Dashboard page and just right to the 'Account Details' you will see `Download YML`, click on it and save the file in your `config/` folder as `cloudinary.yml` file. Keep it as it is. **DO NOT EDIT IT!**
After setting up all this, you're ready to use this webapp.
```bash
rails s
```
---
## Objectives
This web-app must accomplish the following:
- [x] Login users with social services (providers) such as Google, GitHub & Twitter with the help of Devise and Omniauth.
- [x] Make sure there's only one login created for each email regardless of which provider he/she uses.
- [x] If a user signs in with the same email but with a different provider, automatically sign in with the provider they logged in initially.
- [x] After user signs in, they can add more info about them via the Profile page.
- [x] Ability to add profile photos via Active Storage & Cloudinary and display photos on the page with a focus on the face.
- [x] Users can then add notes, quotes, etc to their feed. Show error when they try to add an empty post.
- [x] Show users' posts on their homepage sorted from the latest.
- [x] Provide users the ability to search words or expressions of the post they created through the Search Form gem.
- [x] Show appropriate flash messages wherever necessary.
- [x] Show sign-up count to logged-out users.
- [x] Build a responsive site using bootstrap.
- [x] When a user manually enters a URL that doesn't exist, redirect them to the homepage with a flash message informing them that the URL doesn't exist.
---
## Required Gems
**This project was built on Ruby version _3.1.2_.**
Following important gems were installed in these versions:
| **Gem Names** | **Gem** | **Version** | **Use** |
| :-----------: | :----------------: | :---------: | :----------------------------------------------: |
| Rails | _'rails'_ | **6.1.7.2** | _Use for executing and rendering web-app_ |
| Postgresql | _'pg'_ | **1.2.3** | _Use postgres as the database for Active Record_ |
| Bootstrap | _'bootstrap-sass'_ | **3.4.1** | _For SCSS Styling_ |
| Devise | _'devise'_ | **4.8.0** | _Flexible authentication solution_ |
| Omniauth | _'omniauth'_ | **2.0.4** | _Authenticate via Social logins_ |
| Cloudinary | _'cloudinary'_ | **1.21.0** | _A cloud service for storing user images_ |
| Simple Form | _'simple_form'_ | **5.1.0** | _Search query through attributes in database_ |
| Pagy | _'pagy'_ | **5.3.1** | _For Pagination_ |
---
## Setting up a PostgreSQL user
If you don't have a user set on postgres, here's how to set new user:
```bash
sudo -u postgres createuser -s [username]
```
To set a password for this user, log in to the PostgreSQL command line client:
```bash
sudo -u postgres psql
```
Enter the following command to set the password:
```bash
\password your_password
```
Enter and confirm the password. Then exit the PostgreSQL client:
```bash
\q
```
---
## Execution
Run the following commands to execute locally:
The following will install required version of ruby (make sure [rvm is installed](https://rvm.io/rvm/install).)
```bash
rvm use 2.7.2
```
```bash
git clone git@github.com:JuzerShakir/gratify-me.git
```
```bash
cd gratify-me
```
```bash
bundle install
```
#### Imp Note:
To successfully create development and test database, you will need to update `config.database.yml` file with correct postgresql username and password.
To edit the it without exposing your credentials, give the following command:
```bash
EDITOR="code --wait" rails credentials:edit
```
_`code` for Visual Studio Code_
_`subl` for sublime_
This will open `credential.yml` file and enter credential as follows in it:
```
database:
username: your_username
password: your_password
```
Hit `ctrl + s` to save and then close the `credential.yml` file from the editor. This will save the credentials. To check if it did save, run the following inside rails console:
```
Rails.application.credentials.dig(:database, :username)
```
```bash
rails db:create
```
To use Social Login services you will need to create apps for each provider you want to use to generate tokens and secret on their respective developer site.
After creating tokens and secrets for each provider, use `credential.yml` file to store the credentials :
```
provider:
id: abcdefg
secret: xxxxx
```
Replace `provider` with provider name such as google, twitter etc and enter your id and secret for respective providers.
The code in the `config/initializers/devise.rb` helps load these credentials for each provider.
To use cloudinary, make a cloudinary account. After creating, visit Dashboard page and just right to the 'Account Details' you will see `Download YML`, click on it and save the file in your `config/` folder as `cloudinary.yml` file. Keep it as it is. **DO NOT EDIT IT!**
After setting up all this, you're ready to use this webapp.
```bash
rails s
```
---
近期下载者：
相关文件：
收藏者：