Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sacred-g/commerce
Complete commerce auction app. Django Sqlite3 Stripe and Paypal Payments. User to user messaging. responsive
https://github.com/sacred-g/commerce
auction-website commerce cs50w cs50web-project2 django django-application project2 python sqlite3
Last synced: 10 days ago
JSON representation
Complete commerce auction app. Django Sqlite3 Stripe and Paypal Payments. User to user messaging. responsive
- Host: GitHub
- URL: https://github.com/sacred-g/commerce
- Owner: Sacred-G
- Created: 2024-08-08T21:05:40.000Z (3 months ago)
- Default Branch: commerce
- Last Pushed: 2024-08-15T18:59:25.000Z (3 months ago)
- Last Synced: 2024-10-12T07:21:12.556Z (about 1 month ago)
- Topics: auction-website, commerce, cs50w, cs50web-project2, django, django-application, project2, python, sqlite3
- Language: Python
- Homepage: https://sgbouldin.pythonanywhere.com/
- Size: 46.2 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Auction Web Application
# This was created for CS50w project2!!
## Screenshots
| HOMESCREEN | DASHBOARD | PROFILE |
|------------|-----------|---------|
|  |  |  |
| CATEGORY | HELP_LIBRARY | PAYMENT |
|  |  |  |
| CREDITCARD | MESSAGING | RECENTLY_VIEWED |
|  |  |  |
| BUYITNOW | COMMENTS | RECENT_ACTIVITY |
|  |  |  |
## Overview
This is a Django-based web application for online auctions. Users can create listings, bid on items, add items to their watchlist, and interact with other users through a messaging system. The application now includes payment processing integration with PayPal and Stripe.
## Features
* User authentication (register, login, logout)
* Create, edit, and close auction listings
* Bid on active auctions
* Add items to a personal watchlist
* Comment on auction listings
* User messaging system
* User profiles with auction statistics
* Categories for organizing listings
* Dashboard with auction statistics and charts
* Responsive design for mobile and desktop
* Payment processing with PayPal and Stripe
* Photo uploads for auction listings and user profiles
## Technologies Used
* Django 3.x
* Python 3.x
* HTML5
* CSS3
* JavaScript
* Bootstrap 4
* SQLite (default database)
* PayPal SDK
* Stripe API
## Setup and Installation
1. Clone the repository:
```
git clone https://github.com/Sacred-G/commerce.git
cd commerce
```
2. Create a virtual environment and activate it:
```
python -m venv auctionenv
source auctionvenv/bin/activate # On Windows use `auctionenv\Scripts\activate`
```
3. Install the required packages:
```
pip install -r requirements.txt
```
4. Set up environment variables for PayPal and Stripe:
```
export PAYPAL_CLIENT_ID=your_paypal_client_id
export PAYPAL_SECRET=your_paypal_secret
export STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
export STRIPE_SECRET_KEY=your_stripe_secret_key
```
5. Run migrations:
```
python manage.py migrate
```
6. Create a superuser:
```
python manage.py createsuperuser
```
7. Run the development server:
```
python manage.py runserver
```
8. Open a web browser and navigate to `http://127.0.0.1:8000/`
## Adding Photos
To enable photo uploads for auction listings and user profiles:
1. Update your settings.py:
```python
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
```
2. Update your main urls.py to serve media files during development:
```python
from django.conf import settings
from django.conf.urls.static import static
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
```
3. Add ImageField to your models:
```python
from django.db import models
class AuctionListing(models.Model):
# ... other fields ...
image = models.ImageField(upload_to='auction_images/', blank=True, null=True)
class Profile(models.Model):
# ... other fields ...
profile_picture = models.ImageField(upload_to='profile_pics/', blank=True, null=True)
```
4. Install Pillow for image processing:
```
pip install Pillow
```
5. Update your forms to include file upload fields:
```python
from django import forms
from .models import AuctionListing, Profile
class AuctionListingForm(forms.ModelForm):
class Meta:
model = AuctionListing
fields = ['title', 'description', 'starting_bid', 'image', ...]
class ProfileForm(forms.ModelForm):
class Meta:
model = Profile
fields = ['bio', 'profile_picture', ...]
```
6. In your templates, use the correct enctype for file uploads:
```html
{% csrf_token %}
{{ form.as_p }}
Submit
```
7. Display images in your templates:
```html
{% if auction.image %}
{% endif %}
```
Remember to handle cases where images might not exist to avoid errors in your templates.
## Usage
* Register a new account or log in
* Create new auction listings with photos
* Browse active auctions
* Place bids on items
* Add items to your watchlist
* Leave comments on auction pages
* Use the messaging system to contact other users
* View and update your profile, including profile picture
* Process payments using PayPal or Stripe when winning an auction
## Credit
Thanks to BobsProgrammingAcademy for the dashboard. His work inspired the design
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is open source and available under the [MIT License](LICENSE).