2
2
3
3
![ Tests] ( https://github.com/adamspd/django-appointment/actions/workflows/tests.yml/badge.svg )
4
4
![ Published on PyPi] ( https://github.com/adamspd/django-appointment/actions/workflows/publish.yml/badge.svg )
5
+ [ ![ Doc] ( https://github.com/adamspd/django-appointment-doc/actions/workflows/build-docs.yml/badge.svg )] ( https://django-appt-doc.adamspierredavid.com/overview.html )
5
6
[ ![ Current Release Version] ( https://img.shields.io/github/release/adamspd/django-appointment.svg?style=flat-square&logo=github )] ( https://github.com/adamspd/django-appointment/releases )
6
7
[ ![ pypi Version] ( https://img.shields.io/pypi/v/django-appointment.svg?style=flat-square&logo=pypi&logoColor=white )] ( https://pypi.org/project/django-appointment/ )
7
8
[ ![ PyPi downloads] ( https://static.pepy.tech/personalized-badge/django-appointment?period=total&units=international_system&left_color=grey&right_color=orange&left_text=pip%20downloads )] ( https://pypi.org/project/django-appointment/ )
16
17
[ ![ Django compatible version] ( https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/adamspd/django-appointment/main/django_compatible.json )] ( https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md )
17
18
[ ![ Python compatible version] ( https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/adamspd/django-appointment/main/python_compatible.json )] ( https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md )
18
19
20
+ 🆕 ** New** : The documentation website is now
21
+ available [ here] ( https://django-appt-doc.adamspierredavid.com/overview.html ) . It includes reasons for using the
22
+ application, its features, and detailed configuration instructions.
19
23
20
24
⚠️ ** IMPORTANT** : If upgrading from a version before 2.x.x, please note significant database changes were introduced in
21
25
version 2.0.0. Please read
@@ -98,14 +102,14 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
98
102
AUTH_USER_MODEL = ' client.UserClient'
99
103
```
100
104
101
- But if you're using the default Django user model (like most of us), there's no need to add this line since Django
105
+ But if you're using the default Django user model (like most of us), there's no need to add this line since Django
102
106
automatically sets it to:
103
107
104
108
``` python
105
109
AUTH_USER_MODEL = ' auth.User'
106
110
```
107
111
108
- Ensure your ` create_user ` function includes the following arguments, even if they are not all used (in case you're
112
+ Ensure your ` create_user ` function includes the following arguments, even if they are not all used (in case you're
109
113
using a custom user model with your own logic for creating users):
110
114
111
115
``` python
@@ -131,7 +135,7 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
131
135
To be able to send email reminders after adding ` django_q ` to your ` INSTALLED_APPS ` , you must add this variable
132
136
` Q_CLUSTER ` in your Django's ` settings.py ` . If done, and users check the box to receive reminders, you and them
133
137
will receive an email reminder 24 hours before the appointment.
134
-
138
+
135
139
Here's a configuration example, that you can use without modification (if you don't want to do much research):
136
140
137
141
``` python
@@ -146,7 +150,7 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
146
150
}
147
151
```
148
152
149
- 5 . Next would be to create the migrations and run them by doing ` python manage.py makemigrations appointment ` and right
153
+ 5 . Next would be to create the migrations and run them by doing ` python manage.py makemigrations appointment ` and right
150
154
after, run ` python manage.py migrate ` to create the appointment models.
151
155
152
156
6 . Start the Django Q cluster with ` python manage.py qcluster ` .
@@ -186,15 +190,15 @@ Here's how you can set it up:
186
190
cd django-appointment
187
191
```
188
192
189
- 2 . ** Prepare an .env File** : Create an ` .env ` file in the root directory of your project with your configuration
193
+ 2 . ** Prepare an .env File** : Create an ` .env ` file in the root directory of your project with your configuration
190
194
settings.
191
195
You should include your email host user and password for Django's email functionality (if you want it to work):
192
196
193
197
``` plaintext
194
198
195
199
EMAIL_HOST_PASSWORD=your_password
196
200
```
197
-
201
+
198
202
> ** Note:** The ` .env ` file is used to store sensitive information and should not be committed to version control.
199
203
200
204
3 . ** Build and Run the Docker Containers** : Run the following command to build and run the Docker containers:
@@ -218,8 +222,8 @@ Here's how you can set it up:
218
222
``` bash
219
223
docker compose exec web python manage.py makemigrations appointment
220
224
```
221
-
222
- Then, apply the migrations with the following command:
225
+
226
+ Then, apply the migrations with the following command:
223
227
``` bash
224
228
docker-compose exec web python manage.py migrate
225
229
```
@@ -251,7 +255,7 @@ Here's how you can set it up:
251
255
```
252
256
253
257
> **Note:** I used the default database settings for the Docker container.
254
- > If you want to use a different database, you can modify the Dockerfile and docker-compose.yml files to use your
258
+ > If you want to use a different database, you can modify the Dockerfile and docker-compose.yml files to use your
255
259
> preferred database.
256
260
257
261
## Customization 🔧
@@ -265,9 +269,10 @@ Here's how you can set it up:
265
269
# # Compatibility Matrix 📊
266
270
267
271
A compatibility matrix is available to help you determine which versions of Django and Python are compatible with the
268
- package.
272
+ package.
269
273
The matrix is updated regularly to reflect the latest compatibility test results. For more information, please
270
- refer to the [compatibility matrix here](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md).
274
+ refer to
275
+ the [compatibility matrix here](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md).
271
276
272
277
# # Support 💬
273
278
0 commit comments