Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/devmahmud/django-poll-app

Django poll app is a full featured polling app. You have to register in this app to show the polls and to vote. If you already voted you can not vote again. Only the owner of a poll can add poll , edit poll, update poll, delete poll , add choice, update choice, delete choice and end a poll. If a poll is ended it can not be voted. Ended poll only shows user the final result of the poll. There is a search option for polls. Also user can filter polls by name, publish date, and by number of voted. Pagination will work even after applying filter.
https://github.com/devmahmud/django-poll-app

bootstrap4 django django-application django-project

Last synced: 3 days ago
JSON representation

Host: GitHub
URL: https://github.com/devmahmud/django-poll-app
Owner: devmahmud
License: mit
Created: 2019-01-19T07:38:25.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-10-08T06:51:21.000Z (4 months ago)
Last Synced: 2025-01-11T14:04:55.170Z (10 days ago)
Topics: bootstrap4, django, django-application, django-project
Language: Python
Size: 2.82 MB
Stars: 309
Watchers: 11
Forks: 172
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Django-Poll-App

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

python== 3.5 or up and django==2.0 or up

Installing

open terminal and type

git clone https://github.com/devmahmud/Django-poll-app.git

or simply download using the url below

https://github.com/devmahmud/Django-poll-app.git

To migrate the database open terminal in project directory and type

python manage.py makemigrations

python manage.py migrate

To use admin panel you need to create superuser using this command

python manage.py createsuperuser

To Create some dummy text data for your app follow the step below:

pip install faker
python manage.py shell
import seeder
seeder.seed_all(30)

Here 30 is a number of entry. You can use it as your own

## Configure Email - Poll Owner receives Email when vote is cast by user

- Get your smtp host details and replace following values in your `settings.py`

```text
# Configure email settings
EMAIL_HOST = ''
EMAIL_PORT = ''
EMAIL_HOST_USER = ''
EMAIL_HOST_PASSWORD = ''
DEFAULT_FROM_EMAIL = ''
```
## Getting an OpenAI API Key

1. **Sign Up for an OpenAI Account:**
- Go to [OpenAI’s website](https://www.openai.com/) and sign up for an account if you don't have one.

2. **Navigate to API Keys:**
- After logging in, go to the API section of your account by visiting [OpenAI API Keys](https://platform.openai.com/account/api-keys).

3. **Create a New API Key:**
- Click on the "Create new key" button. A new API key will be generated for you.

4. **Copy Your API Key:**
- Copy the API key to your clipboard. You will need this key to access OpenAI services.

5. **Set Up Your Environment:**
- Add the API key to your environment variables. You can do this by setting an environment variable in your terminal or adding it to a `.env` file or add in settings.py . For example, you can set it in your `.env` file like this:
```
OPENAI_API_KEY=your_api_key_here
```

Configuring OAuth login

Obtaining OAuth Client ID for Google

1. **Go to the Google Cloud Console:**
- Navigate to [Google Cloud Console](https://console.cloud.google.com/).
- Sign in with your Google account.

2. **Create a new project:**
- Click on the project dropdown menu at the top of the page.
- Click on "New Project" and follow the prompts to create a new project.

3. **Enable the Google Identity service:**
- In the Google Cloud Console, navigate to "APIs & Services" > "Dashboard."
- Click on "Enable APIs and Services."
- Search for "Google Identity" or "Google+ API" and enable it for your project.

4. **Create OAuth consent screen:**
- In the Google Cloud Console, navigate to "APIs & Services" > "OAuth consent screen."
- Fill in the required fields (like application name, user support email, etc.).
- Add scopes (permissions) your application requires.
- Save the consent screen information.

5. **Create OAuth credentials:**
- In the Google Cloud Console, navigate to "APIs & Services" > "Credentials."
- Click on "Create Credentials" > "OAuth client ID."
- Select "Web application" as the application type.
- Enter a name for your OAuth client.
- Add authorized redirect URIs : `http://127.0.0.1:8000/complete/google-oauth2/`
- Click "Create."

6. **Copy the client ID and client secret:**
- Once the OAuth client is created, you'll see your client ID and client secret.
- Copy these values and update the following variables in settings.py

```
SOCIAL_AUTH_GOOGLE_OAUTH2_KEY = 'your-client-id'
SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET = 'your-client-secret'
```

For detailed instructions, refer to Google's documentation on [OAuth 2.0](https://developers.google.com/identity/protocols/oauth2).

Obtaining OAuth Client ID for Facebook

1. **Create a Facebook App:**
- Go to the [Facebook Developers](https://developers.facebook.com/) website and log in.
- Click on "My Apps" and then "Create App".
- Enter the required information for your app (display name, contact email, etc.) and create the app.

2. **Configure Basic Settings:**
- In your app dashboard, go to Settings > Basic.
- Add a platform (select Website) and enter your site URL(http://127.0.0.1:8000/complete/facebook/).
- Save your changes.

3. **Get App ID and App Secret:**

- Update the following settings to your settings file, replacing `'your-facebook-client-id'` and `'your-facebook-client-secret'` with your actual LinkedIn app credentials:
```python
SOCIAL_AUTH_FACEBOOK_OAUTH2_KEY = 'your-client-id'
SOCIAL_AUTH_FACEBOOK_OAUTH2_SECRET = 'your-client-secret'
```

Obtaining OAuth Client ID for LinkedIn

### Step 1: Create a LinkedIn App
1. Go to the [LinkedIn Developer Portal](https://www.linkedin.com/developers/) and sign in.
2. Click on "Create App" and fill in the required details, such as the app name, description, and logo.
3. In the "Authorized Redirect URLs" section, add the callback URL for your Django app. This URL will be like `http://127.0.0.1:8000/complete/linkedin/`.
4. Save the changes and note down the Client ID and Client Secret provided by LinkedIn.

### Step 2: Configure Django Settings

1. Update the following settings to your settings file, replacing `'your-linkedin-client-id'` and `'your-linkedin-client-secret'` with your actual LinkedIn app credentials:
```python
SOCIAL_AUTH_LINKEDIN_OAUTH2_KEY = 'your-client-id'
SOCIAL_AUTH_LINKEDIN_OAUTH2_SECRET = 'your-client-secret'
```