| 171 | | **ParamÚtres requis :** |
|---|
| 172 | | |
|---|
| 173 | | * ``queryset``: un ``QuerySet`` d'objets pour lesquels la page sera |
|---|
| 174 | | utilisée. |
|---|
| 175 | | |
|---|
| 176 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 177 | | le modÚle du ``QuerySet`` que la page basée sur les dates doit utiliser |
|---|
| 178 | | pour déterminer quels objets seront affichés. |
|---|
| 179 | | |
|---|
| 180 | | **ParamÚtres optionnels :** |
|---|
| 181 | | |
|---|
| 182 | | * ``num_latest``: le nombre d'objets à envoyer au contexte du template. La |
|---|
| 183 | | valeur par défaut est 15. |
|---|
| 184 | | |
|---|
| 185 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 186 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 187 | | ci-dessous). |
|---|
| 188 | | |
|---|
| 189 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 190 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 191 | | |
|---|
| 192 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 193 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 194 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 195 | | juste avant le rendu du template. |
|---|
| 196 | | |
|---|
| 197 | | * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la |
|---|
| 198 | | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| 199 | | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| 200 | | d'envoyer une page vide. La valeur par défaut est ``True``. |
|---|
| 201 | | |
|---|
| 202 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 203 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 204 | | RequestContext`_. |
|---|
| 205 | | |
|---|
| 206 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 207 | | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 208 | | |
|---|
| 209 | | * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les |
|---|
| 210 | | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| 211 | | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| 212 | | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| 213 | | |
|---|
| 214 | | * **Nouveau dans la version de développement de Django :** |
|---|
| 215 | | ``template_object_name``: désigne le nom de la variable de template à |
|---|
| 216 | | utiliser dans le contexte du template. La valeur par défaut est |
|---|
| 217 | | ``'latest'``. |
|---|
| 218 | | |
|---|
| 219 | | **Nom du template :** |
|---|
| | 181 | ParamÚtres requis |
|---|
| | 182 | ~~~~~~~~~~~~~~~~~ |
|---|
| | 183 | |
|---|
| | 184 | ``queryset`` |
|---|
| | 185 | Un ``QuerySet`` d'objets pour lesquels la page sera |
|---|
| | 186 | utilisée. |
|---|
| | 187 | |
|---|
| | 188 | ``date_field`` |
|---|
| | 189 | Le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| | 190 | le modÚle du ``QuerySet`` que la page basée sur les dates doit utiliser |
|---|
| | 191 | pour déterminer quels objets seront affichés. |
|---|
| | 192 | |
|---|
| | 193 | ParamÚtres optionnels |
|---|
| | 194 | ~~~~~~~~~~~~~~~~~~~~~ |
|---|
| | 195 | |
|---|
| | 196 | ``num_latest`` |
|---|
| | 197 | Le nombre d'objets à envoyer au contexte du template. La |
|---|
| | 198 | valeur par défaut est 15. |
|---|
| | 199 | |
|---|
| | 200 | ``template_name`` |
|---|
| | 201 | Le nom complet du template à utiliser pour rendre la |
|---|
| | 202 | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| | 203 | ci-dessous). |
|---|
| | 204 | |
|---|
| | 205 | ``template_loader`` |
|---|
| | 206 | Le chargeur de template à utiliser pour charger le |
|---|
| | 207 | template. Par défaut, c'est ``django.template.loader``. |
|---|
| | 208 | |
|---|
| | 209 | ``extra_context`` |
|---|
| | 210 | Un dictionnaire de valeurs à ajouter au contexte du |
|---|
| | 211 | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| | 212 | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| | 213 | juste avant le rendu du template. |
|---|
| | 214 | |
|---|
| | 215 | ``allow_empty`` |
|---|
| | 216 | Une valeur booléenne qui indique s'il faut afficher la |
|---|
| | 217 | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| | 218 | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| | 219 | d'envoyer une page vide. La valeur par défaut est ``True``. |
|---|
| | 220 | |
|---|
| | 221 | ``context_processors`` |
|---|
| | 222 | Une liste de processeurs de contexte de template |
|---|
| | 223 | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| | 224 | RequestContext`_. |
|---|
| | 225 | |
|---|
| | 226 | ``mimetype`` |
|---|
| | 227 | Le type MIME à utiliser pour le document résultant. La |
|---|
| | 228 | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| | 229 | |
|---|
| | 230 | ``allow_future`` |
|---|
| | 231 | Une valeur booléenne indiquant s'il faut inclure les |
|---|
| | 232 | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| | 233 | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| | 234 | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| | 235 | |
|---|
| | 236 | ``template_object_name`` (**Nouveau dans la version de développement de Django**) |
|---|
| | 237 | Désigne le nom de la variable de template à |
|---|
| | 238 | utiliser dans le contexte du template. La valeur par défaut est |
|---|
| | 239 | ``'latest'``. |
|---|
| | 240 | |
|---|
| | 241 | Nom du template |
|---|
| | 242 | ~~~~~~~~~~~~~~~ |
|---|
| 235 | | * ``date_list``: une liste d'objets ``datetime.date`` représentant toutes |
|---|
| 236 | | les années pour lesquelles le ` queryset`` renverra des objets, triée en |
|---|
| 237 | | descendant. C'est équivalent à ``queryset.dates(date_field, |
|---|
| 238 | | 'year')[::-1]``. |
|---|
| 239 | | |
|---|
| 240 | | * ``latest``: les ``num_latest`` objets du systÚme, triés en ordre |
|---|
| 241 | | descendant sur ``date_field``. Par exemple, si ``num_latest`` vaut 10, |
|---|
| 242 | | ``latest`` sera la liste des 10 objets les plus récents du ``queryset``. |
|---|
| 243 | | |
|---|
| 244 | | **Nouveau dans la version de développement de Django :** le nom de |
|---|
| 245 | | cette variable dépend du paramÚtre ``template_object_name``, qui est |
|---|
| 246 | | ``'latest'`` par défaut. Si ``template_object_name`` est ``'foo'``, |
|---|
| 247 | | le nom de cette variable sera ``'foo'``. |
|---|
| | 259 | ``date_list`` |
|---|
| | 260 | Une liste d'objets ``datetime.date`` représentant toutes |
|---|
| | 261 | les années pour lesquelles le ` queryset`` renverra des objets, triée en |
|---|
| | 262 | descendant. C'est équivalent à ``queryset.dates(date_field, |
|---|
| | 263 | 'year')[::-1]``. |
|---|
| | 264 | |
|---|
| | 265 | ``latest`` |
|---|
| | 266 | Les ``num_latest`` objets du systÚme, triés en ordre |
|---|
| | 267 | descendant sur ``date_field``. Par exemple, si ``num_latest`` vaut 10, |
|---|
| | 268 | ``latest`` sera la liste des 10 objets les plus récents du ``queryset``. |
|---|
| | 269 | |
|---|
| | 270 | **Nouveau dans la version de développement de Django :** le nom de |
|---|
| | 271 | cette variable dépend du paramÚtre ``template_object_name``, qui est |
|---|
| | 272 | ``'latest'`` par défaut. Si ``template_object_name`` est ``'foo'``, |
|---|
| | 273 | le nom de cette variable sera ``'foo'``. |
|---|
| 261 | | **ParamÚtres requis :** |
|---|
| 262 | | |
|---|
| 263 | | * ``year``: l'année de l'archive sur 4 chiffres. |
|---|
| 264 | | |
|---|
| 265 | | * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| 266 | | |
|---|
| 267 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 268 | | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| 269 | | les objets à renvoyer dans la page. |
|---|
| 270 | | |
|---|
| 271 | | **ParamÚtres optionnels :** |
|---|
| 272 | | |
|---|
| 273 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 274 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 275 | | ci-dessous). |
|---|
| 276 | | |
|---|
| 277 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 278 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 279 | | |
|---|
| 280 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 281 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 282 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 283 | | juste avant le rendu du template. |
|---|
| 284 | | |
|---|
| 285 | | * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la |
|---|
| 286 | | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| 287 | | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| 288 | | d'envoyer une page vide. La valeur par défaut est ``True``. |
|---|
| 289 | | |
|---|
| 290 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 291 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 292 | | RequestContext`_. |
|---|
| 293 | | |
|---|
| 294 | | * ``template_object_name``: indique le nom de la variable de template à |
|---|
| 295 | | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| 296 | | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| 297 | | déterminer le nom de la variable. |
|---|
| 298 | | |
|---|
| 299 | | * ``make_object_list``: un booléen indiquant s'il faut retrouver la |
|---|
| 300 | | totalité de la liste des objets pour cette année et la passer au |
|---|
| 301 | | template. Si ``True``, la liste d'objets sera passée au template sous le |
|---|
| 302 | | nom de ``object_list``. (Le nom ``object_list`` peut être différent, |
|---|
| 303 | | voir les précisions sur ``object_list`` dans la section "Contexte du |
|---|
| 304 | | template" ci-dessous). La valeur par défaut est ``False``. |
|---|
| 305 | | |
|---|
| 306 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 307 | | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 308 | | |
|---|
| 309 | | * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les |
|---|
| 310 | | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| 311 | | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| 312 | | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| 313 | | |
|---|
| 314 | | **Nom du template :** |
|---|
| | 288 | ParamÚtres requis |
|---|
| | 289 | ~~~~~~~~~~~~~~~~~ |
|---|
| | 290 | |
|---|
| | 291 | ``year`` |
|---|
| | 292 | L'année de l'archive sur 4 chiffres. |
|---|
| | 293 | |
|---|
| | 294 | ``queryset`` |
|---|
| | 295 | Un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| | 296 | |
|---|
| | 297 | ``date_field`` |
|---|
| | 298 | Le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| | 299 | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| | 300 | les objets à renvoyer dans la page. |
|---|
| | 301 | |
|---|
| | 302 | ParamÚtres optionnels |
|---|
| | 303 | ~~~~~~~~~~~~~~~~~~~~~ |
|---|
| | 304 | |
|---|
| | 305 | ``template_name`` |
|---|
| | 306 | Le nom complet du template à utiliser pour rendre la |
|---|
| | 307 | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| | 308 | ci-dessous). |
|---|
| | 309 | |
|---|
| | 310 | ``template_loader`` |
|---|
| | 311 | Le chargeur de template à utiliser pour charger le |
|---|
| | 312 | template. Par défaut, c'est ``django.template.loader``. |
|---|
| | 313 | |
|---|
| | 314 | ``extra_context`` |
|---|
| | 315 | Un dictionnaire de valeurs à ajouter au contexte du |
|---|
| | 316 | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| | 317 | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| | 318 | juste avant le rendu du template. |
|---|
| | 319 | |
|---|
| | 320 | ``allow_empty`` |
|---|
| | 321 | Une valeur booléenne qui indique s'il faut afficher la |
|---|
| | 322 | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| | 323 | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| | 324 | d'envoyer une page vide. La valeur par défaut est ``True``. |
|---|
| | 325 | |
|---|
| | 326 | ``context_processors`` |
|---|
| | 327 | Une liste de processeurs de contexte de template |
|---|
| | 328 | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| | 329 | RequestContext`_. |
|---|
| | 330 | |
|---|
| | 331 | ``template_object_name`` |
|---|
| | 332 | Indique le nom de la variable de template à |
|---|
| | 333 | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| | 334 | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| | 335 | déterminer le nom de la variable. |
|---|
| | 336 | |
|---|
| | 337 | ``make_object_list`` |
|---|
| | 338 | Un booléen indiquant s'il faut retrouver la |
|---|
| | 339 | totalité de la liste des objets pour cette année et la passer au |
|---|
| | 340 | template. Si ``True``, la liste d'objets sera passée au template sous le |
|---|
| | 341 | nom de ``object_list``. (Le nom ``object_list`` peut être différent, |
|---|
| | 342 | voir les précisions sur ``object_list`` dans la section "Contexte du |
|---|
| | 343 | template" ci-dessous). La valeur par défaut est ``False``. |
|---|
| | 344 | |
|---|
| | 345 | ``mimetype`` |
|---|
| | 346 | Le type MIME à utiliser pour le document résultant. La |
|---|
| | 347 | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| | 348 | |
|---|
| | 349 | ``allow_future`` |
|---|
| | 350 | Une valeur booléenne indiquant s'il faut inclure les |
|---|
| | 351 | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| | 352 | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| | 353 | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| | 354 | |
|---|
| | 355 | Nom du template |
|---|
| | 356 | ~~~~~~~~~~~~~~~ |
|---|
| 323 | | * ``date_list``: une liste d'objets ``datetime.date`` représentant tous |
|---|
| 324 | | les mois pour lesquels le ``queryset`` a renvoyé des objets pour l'année |
|---|
| 325 | | considérée, dans l'ordre ascendant. |
|---|
| 326 | | |
|---|
| 327 | | * ``year``: l'année considérée, sous forme d'une chaîne de 4 chiffres. |
|---|
| 328 | | |
|---|
| 329 | | * ``object_list``: si le paramÚtre ``make_object_list`` vaut ``True``, |
|---|
| 330 | | renverra une liste des objets disponibles pour l'année considérée, triée |
|---|
| 331 | | sur le champ date. Le nom de cette variable dépend du paramÚtre |
|---|
| 332 | | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| 333 | | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| 334 | | ``foo_list``. |
|---|
| 335 | | |
|---|
| 336 | | Si ``make_object_list`` vaut ``False``, ``object_list`` sera passé au |
|---|
| 337 | | template comme une liste vide. |
|---|
| | 366 | ``date_list`` |
|---|
| | 367 | Une liste d'objets ``datetime.date`` représentant tous |
|---|
| | 368 | les mois pour lesquels le ``queryset`` a renvoyé des objets pour l'année |
|---|
| | 369 | considérée, dans l'ordre ascendant. |
|---|
| | 370 | |
|---|
| | 371 | ``year`` |
|---|
| | 372 | L'année considérée, sous forme d'une chaîne de 4 chiffres. |
|---|
| | 373 | |
|---|
| | 374 | ``object_list`` |
|---|
| | 375 | Si le paramÚtre ``make_object_list`` vaut ``True``, |
|---|
| | 376 | renverra une liste des objets disponibles pour l'année considérée, triée |
|---|
| | 377 | sur le champ date. Le nom de cette variable dépend du paramÚtre |
|---|
| | 378 | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| | 379 | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| | 380 | ``foo_list``. |
|---|
| | 381 | |
|---|
| | 382 | Si ``make_object_list`` vaut ``False``, ``object_list`` sera passé au |
|---|
| | 383 | template comme une liste vide. |
|---|
| 348 | | **ParamÚtres requis :** |
|---|
| 349 | | |
|---|
| 350 | | * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| 351 | | 4 chiffres). |
|---|
| 352 | | |
|---|
| 353 | | * ``month``: le mois pour lequel l'archive est recherchée, au format indiqué |
|---|
| 354 | | par le paramÚtre ``month_format``. |
|---|
| 355 | | |
|---|
| 356 | | * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| 357 | | |
|---|
| 358 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 359 | | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| 360 | | les objets à renvoyer dans la page. |
|---|
| 361 | | |
|---|
| 362 | | **ParamÚtres optionnels :** |
|---|
| 363 | | |
|---|
| 364 | | * ``month_format``: une chaîne de format qui indique celui qui doit être |
|---|
| 365 | | utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée |
|---|
| 366 | | par la fonction Python ``time.strftime``. (Voir la `documentation de |
|---|
| 367 | | strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois |
|---|
| 368 | | abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez |
|---|
| 369 | | ``"%m"``. |
|---|
| 370 | | |
|---|
| 371 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 372 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 373 | | ci-dessous). |
|---|
| 374 | | |
|---|
| 375 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 376 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 377 | | |
|---|
| 378 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 379 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 380 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 381 | | juste avant le rendu du template. |
|---|
| 382 | | |
|---|
| 383 | | * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la |
|---|
| 384 | | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| 385 | | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| 386 | | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| 387 | | |
|---|
| 388 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 389 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 390 | | RequestContext`_. |
|---|
| 391 | | |
|---|
| 392 | | * ``template_object_name``: indique le nom de la variable de template à |
|---|
| 393 | | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| 394 | | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| 395 | | déterminer le nom de la variable. |
|---|
| 396 | | |
|---|
| 397 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 398 | | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 399 | | |
|---|
| 400 | | * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les |
|---|
| 401 | | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| 402 | | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| 403 | | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| 404 | | |
|---|
| 405 | | **Nom du template :** |
|---|
| | 395 | ParamÚtres requis |
|---|
| | 396 | ~~~~~~~~~~~~~~~~~ |
|---|
| | 397 | |
|---|
| | 398 | ``year`` |
|---|
| | 399 | L'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| | 400 | 4 chiffres). |
|---|
| | 401 | |
|---|
| | 402 | ``month`` |
|---|
| | 403 | Le mois pour lequel l'archive est recherchée, au format indiqué |
|---|
| | 404 | par le paramÚtre ``month_format``. |
|---|
| | 405 | |
|---|
| | 406 | ``queryset`` |
|---|
| | 407 | Un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| | 408 | |
|---|
| | 409 | ``date_field`` |
|---|
| | 410 | Le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| | 411 | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| | 412 | les objets à renvoyer dans la page. |
|---|
| | 413 | |
|---|
| | 414 | ParamÚtres optionnels |
|---|
| | 415 | ~~~~~~~~~~~~~~~~~~~~~ |
|---|
| | 416 | |
|---|
| | 417 | ``month_format`` |
|---|
| | 418 | Une chaîne de format qui indique celui qui doit être |
|---|
| | 419 | utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée |
|---|
| | 420 | par la fonction Python ``time.strftime``. (Voir la `documentation de |
|---|
| | 421 | strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois |
|---|
| | 422 | abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez |
|---|
| | 423 | ``"%m"``. |
|---|
| | 424 | |
|---|
| | 425 | ``template_name`` |
|---|
| | 426 | Le nom complet du template à utiliser pour rendre la |
|---|
| | 427 | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| | 428 | ci-dessous). |
|---|
| | 429 | |
|---|
| | 430 | ``template_loader`` |
|---|
| | 431 | Le chargeur de template à utiliser pour charger le |
|---|
| | 432 | template. Par défaut, c'est ``django.template.loader``. |
|---|
| | 433 | |
|---|
| | 434 | ``extra_context`` |
|---|
| | 435 | Un dictionnaire de valeurs à ajouter au contexte du |
|---|
| | 436 | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| | 437 | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| | 438 | juste avant le rendu du template. |
|---|
| | 439 | |
|---|
| | 440 | ``allow_empty`` |
|---|
| | 441 | Une valeur booléenne qui indique s'il faut afficher la |
|---|
| | 442 | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| | 443 | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| | 444 | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| | 445 | |
|---|
| | 446 | ``context_processors`` |
|---|
| | 447 | Une liste de processeurs de contexte de template |
|---|
| | 448 | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| | 449 | RequestContext`_. |
|---|
| | 450 | |
|---|
| | 451 | ``template_object_name`` |
|---|
| | 452 | Indique le nom de la variable de template à |
|---|
| | 453 | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| | 454 | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| | 455 | déterminer le nom de la variable. |
|---|
| | 456 | |
|---|
| | 457 | ``mimetype`` |
|---|
| | 458 | Le type MIME à utiliser pour le document résultant. La |
|---|
| | 459 | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| | 460 | |
|---|
| | 461 | ``allow_future`` |
|---|
| | 462 | Une valeur booléenne indiquant s'il faut inclure les |
|---|
| | 463 | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| | 464 | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| | 465 | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| | 466 | |
|---|
| | 467 | Nom du template |
|---|
| | 468 | ~~~~~~~~~~~~~~~ |
|---|
| 414 | | * ``month``: un objet ``datetime.date`` représentant le mois considéré. |
|---|
| 415 | | |
|---|
| 416 | | * ``next_month``: un objet ``datetime.date`` représentant le premier jour |
|---|
| 417 | | du mois suivant le mois considéré. Si le mois suivant est dans le futur, |
|---|
| 418 | | la valeur sera ``None``. |
|---|
| 419 | | |
|---|
| 420 | | * ``previous_month``: un objet ``datetime.date`` représentant le premier |
|---|
| 421 | | jour du mois précédent. A l'inverse de ``next_month``, ne vaudra jamais |
|---|
| 422 | | ``None``. |
|---|
| 423 | | |
|---|
| 424 | | * ``object_list``: une liste d'objets disponibles pour le mois considéré. |
|---|
| 425 | | Le nom de cette variable dépend du paramÚtre |
|---|
| 426 | | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| 427 | | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| 428 | | ``foo_list``. |
|---|
| | 478 | ``month`` |
|---|
| | 479 | Un objet ``datetime.date`` représentant le mois considéré. |
|---|
| | 480 | |
|---|
| | 481 | ``next_month`` |
|---|
| | 482 | Un objet ``datetime.date`` représentant le premier jour |
|---|
| | 483 | du mois suivant le mois considéré. Si le mois suivant est dans le futur, |
|---|
| | 484 | la valeur sera ``None``. |
|---|
| | 485 | |
|---|
| | 486 | ``previous_month`` |
|---|
| | 487 | Un objet ``datetime.date`` représentant le premier |
|---|
| | 488 | jour du mois précédent. A l'inverse de ``next_month``, ne vaudra jamais |
|---|
| | 489 | ``None``. |
|---|
| | 490 | |
|---|
| | 491 | ``object_list`` |
|---|
| | 492 | Une liste d'objets disponibles pour le mois considéré. |
|---|
| | 493 | Le nom de cette variable dépend du paramÚtre |
|---|
| | 494 | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| | 495 | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| | 496 | ``foo_list``. |
|---|
| 442 | | **ParamÚtres requis :** |
|---|
| 443 | | |
|---|
| 444 | | * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| 445 | | 4 chiffres). |
|---|
| 446 | | |
|---|
| 447 | | * ``week``: la semaine pour laquelle l'archive est recherchée (une |
|---|
| 448 | | chaîne). Les semaines commencent le dimanche. |
|---|
| 449 | | |
|---|
| 450 | | * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| 451 | | |
|---|
| 452 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 453 | | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| 454 | | les objets à renvoyer dans la page. |
|---|
| 455 | | |
|---|
| 456 | | **ParamÚtres optionnels :** |
|---|
| 457 | | |
|---|
| 458 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 459 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 460 | | ci-dessous). |
|---|
| 461 | | |
|---|
| 462 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 463 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 464 | | |
|---|
| 465 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 466 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 467 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 468 | | juste avant le rendu du template. |
|---|
| 469 | | |
|---|
| 470 | | * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la |
|---|
| 471 | | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| 472 | | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| 473 | | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| 474 | | |
|---|
| 475 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 476 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 477 | | RequestContext`_. |
|---|
| 478 | | |
|---|
| 479 | | * ``template_object_name``: indique le nom de la variable de template à |
|---|
| 480 | | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| 481 | | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| 482 | | déterminer le nom de la variable. |
|---|
| 483 | | |
|---|
| 484 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 485 | | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 486 | | |
|---|
| 487 | | * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les |
|---|
| 488 | | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| 489 | | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| 490 | | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| 491 | | |
|---|
| 492 | | **Nom du template :** |
|---|
| | 511 | ParamÚtres requis |
|---|
| | 512 | ~~~~~~~~~~~~~~~~~ |
|---|
| | 513 | |
|---|
| | 514 | ``year`` |
|---|
| | 515 | L'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| | 516 | 4 chiffres). |
|---|
| | 517 | |
|---|
| | 518 | ``week`` |
|---|
| | 519 | La semaine pour laquelle l'archive est recherchée (une |
|---|
| | 520 | chaîne). Les semaines commencent le dimanche. |
|---|
| | 521 | |
|---|
| | 522 | ``queryset`` |
|---|
| | 523 | Un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| | 524 | |
|---|
| | 525 | ``date_field`` |
|---|
| | 526 | Le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| | 527 | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| | 528 | les objets à renvoyer dans la page. |
|---|
| | 529 | |
|---|
| | 530 | ParamÚtres optionnels |
|---|
| | 531 | ~~~~~~~~~~~~~~~~~~~~~ |
|---|
| | 532 | |
|---|
| | 533 | ``template_name`` |
|---|
| | 534 | Le nom complet du template à utiliser pour rendre la |
|---|
| | 535 | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| | 536 | ci-dessous). |
|---|
| | 537 | |
|---|
| | 538 | ``template_loader`` |
|---|
| | 539 | Le chargeur de template à utiliser pour charger le |
|---|
| | 540 | template. Par défaut, c'est ``django.template.loader``. |
|---|
| | 541 | |
|---|
| | 542 | ``extra_context`` |
|---|
| | 543 | Un dictionnaire de valeurs à ajouter au contexte du |
|---|
| | 544 | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| | 545 | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| | 546 | juste avant le rendu du template. |
|---|
| | 547 | |
|---|
| | 548 | ``allow_empty`` |
|---|
| | 549 | Une valeur booléenne qui indique s'il faut afficher la |
|---|
| | 550 | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| | 551 | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| | 552 | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| | 553 | |
|---|
| | 554 | ``context_processors`` |
|---|
| | 555 | Une liste de processeurs de contexte de template |
|---|
| | 556 | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| | 557 | RequestContext`_. |
|---|
| | 558 | |
|---|
| | 559 | ``template_object_name`` |
|---|
| | 560 | Indique le nom de la variable de template à |
|---|
| | 561 | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| | 562 | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| | 563 | déterminer le nom de la variable. |
|---|
| | 564 | |
|---|
| | 565 | ``mimetype`` |
|---|
| | 566 | Le type MIME à utiliser pour le document résultant. La |
|---|
| | 567 | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| | 568 | |
|---|
| | 569 | ``allow_future`` |
|---|
| | 570 | Une valeur booléenne indiquant s'il faut inclure les |
|---|
| | 571 | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| | 572 | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| | 573 | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| | 574 | |
|---|
| | 575 | Nom du template |
|---|
| | 576 | ~~~~~~~~~~~~~~~ |
|---|
| 521 | | **ParamÚtres requis :** |
|---|
| 522 | | |
|---|
| 523 | | * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| 524 | | 4 chiffres). |
|---|
| 525 | | |
|---|
| 526 | | * ``month``: le mois pour lequel l'archive est recherchée, au format indiqué |
|---|
| 527 | | par le paramÚtre ``month_format``. |
|---|
| 528 | | |
|---|
| 529 | | * ``day``: le jour pour lequel l'archive est recherchée, au format indiqué |
|---|
| 530 | | par le paramÚtre ``day_format``. |
|---|
| 531 | | |
|---|
| 532 | | * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| 533 | | |
|---|
| 534 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 535 | | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| 536 | | les objets à renvoyer dans la page. |
|---|
| 537 | | |
|---|
| 538 | | **ParamÚtres optionnels :** |
|---|
| 539 | | |
|---|
| 540 | | * ``month_format``: une chaîne de format qui indique celui qui doit être |
|---|
| 541 | | utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée |
|---|
| 542 | | par la fonction Python ``time.strftime``. (Voir la `documentation de |
|---|
| 543 | | strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois |
|---|
| 544 | | abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez |
|---|
| 545 | | ``"%m"``. |
|---|
| 546 | | |
|---|
| 547 | | * ``day_format``: comme ``month_format``, mais pour le paramÚtre ``day``. |
|---|
| 548 | | La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). |
|---|
| 549 | | |
|---|
| 550 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 551 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 552 | | ci-dessous). |
|---|
| 553 | | |
|---|
| 554 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 555 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 556 | | |
|---|
| 557 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 558 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 559 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 560 | | juste avant le rendu du template. |
|---|
| 561 | | |
|---|
| 562 | | * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la |
|---|
| 563 | | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| 564 | | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| 565 | | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| 566 | | |
|---|
| 567 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 568 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 569 | | RequestContext`_. |
|---|
| 570 | | |
|---|
| 571 | | * ``template_object_name``: indique le nom de la variable de template à |
|---|
| 572 | | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| 573 | | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| 574 | | déterminer le nom de la variable. |
|---|
| 575 | | |
|---|
| 576 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 577 | | valeur par défaut est celle du rÚglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 578 | | |
|---|
| 579 | | * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les |
|---|
| 580 | | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| 581 | | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| 582 | | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| 583 | | |
|---|
| 584 | | **Nom du template :** |
|---|
| | 609 | ParamÚtres requis |
|---|
| | 610 | ~~~~~~~~~~~~~~~~~ |
|---|
| | 611 | |
|---|
| | 612 | ``year`` |
|---|
| | 613 | L'année pour laquelle l'archive est recherchée (une chaîne de |
|---|
| | 614 | 4 chiffres). |
|---|
| | 615 | |
|---|
| | 616 | ``month`` |
|---|
| | 617 | Le mois pour lequel l'archive est recherchée, au format indiqué |
|---|
| | 618 | par le paramÚtre ``month_format``. |
|---|
| | 619 | |
|---|
| | 620 | ``day`` |
|---|
| | 621 | Le jour pour lequel l'archive est recherchée, au format indiqué |
|---|
| | 622 | par le paramÚtre ``day_format``. |
|---|
| | 623 | |
|---|
| | 624 | ``queryset`` |
|---|
| | 625 | Un ``QuerySet`` d'objets à renvoyer dans l'archive. |
|---|
| | 626 | |
|---|
| | 627 | ``date_field`` |
|---|
| | 628 | Le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| | 629 | le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer |
|---|
| | 630 | les objets à renvoyer dans la page. |
|---|
| | 631 | |
|---|
| | 632 | ParamÚtres optionnels |
|---|
| | 633 | ~~~~~~~~~~~~~~~~~~~~~ |
|---|
| | 634 | |
|---|
| | 635 | ``month_format`` |
|---|
| | 636 | Une chaîne de format qui indique celui qui doit être |
|---|
| | 637 | utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée |
|---|
| | 638 | par la fonction Python ``time.strftime``. (Voir la `documentation de |
|---|
| | 639 | strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois |
|---|
| | 640 | abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez |
|---|
| | 641 | ``"%m"``. |
|---|
| | 642 | |
|---|
| | 643 | ``day_format`` |
|---|
| | 644 | Comme ``month_format``, mais pour le paramÚtre ``day``. |
|---|
| | 645 | La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). |
|---|
| | 646 | |
|---|
| | 647 | ``template_name`` |
|---|
| | 648 | Le nom complet du template à utiliser pour rendre la |
|---|
| | 649 | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| | 650 | ci-dessous). |
|---|
| | 651 | |
|---|
| | 652 | ``template_loader`` |
|---|
| | 653 | Le chargeur de template à utiliser pour charger le |
|---|
| | 654 | template. Par défaut, c'est ``django.template.loader``. |
|---|
| | 655 | |
|---|
| | 656 | ``extra_context`` |
|---|
| | 657 | Un dictionnaire de valeurs à ajouter au contexte du |
|---|
| | 658 | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| | 659 | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| | 660 | juste avant le rendu du template. |
|---|
| | 661 | |
|---|
| | 662 | ``allow_empty`` |
|---|
| | 663 | Une valeur booléenne qui indique s'il faut afficher la |
|---|
| | 664 | page si aucun objet n'est disponible. Si la valeur est ``False`` et |
|---|
| | 665 | qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu |
|---|
| | 666 | d'envoyer une page vide. La valeur par défaut est ``False``. |
|---|
| | 667 | |
|---|
| | 668 | ``context_processors`` |
|---|
| | 669 | Une liste de processeurs de contexte de template |
|---|
| | 670 | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| | 671 | RequestContext`_. |
|---|
| | 672 | |
|---|
| | 673 | ``template_object_name`` |
|---|
| | 674 | Indique le nom de la variable de template à |
|---|
| | 675 | utiliser dans le contexte du template. Par défaut, c'est ``object``. La |
|---|
| | 676 | vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour |
|---|
| | 677 | déterminer le nom de la variable. |
|---|
| | 678 | |
|---|
| | 679 | ``mimetype`` |
|---|
| | 680 | Le type MIME à utiliser pour le document résultant. La |
|---|
| | 681 | valeur par défaut est celle du rÚglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| | 682 | |
|---|
| | 683 | ``allow_future`` |
|---|
| | 684 | Une valeur booléenne indiquant s'il faut inclure les |
|---|
| | 685 | objets "futurs" sur la page, où futur signifie des objets pour lesquels |
|---|
| | 686 | le champ spécifié dans ``date_field`` est plus grand que la date et |
|---|
| | 687 | l'heure courantes. La valeur par défaut est ``False``. |
|---|
| | 688 | |
|---|
| | 689 | Nom du template |
|---|
| | 690 | ~~~~~~~~~~~~~~~ |
|---|
| 593 | | * ``day``: un objet ``datetime.date`` représentant le jour considéré. |
|---|
| 594 | | |
|---|
| 595 | | * ``next_day``: un objet ``datetime.date`` représentant le jour suivant. |
|---|
| 596 | | Si le jour suivant est dans le futur, vaudra ``None``. |
|---|
| 597 | | |
|---|
| 598 | | * ``previous_day``: un objet ``datetime.date`` représentant le jour |
|---|
| 599 | | précédent. Contrairement à ``next_day``, ne vaudra jamais ``None``. |
|---|
| 600 | | |
|---|
| 601 | | * ``object_list``: une liste d'objets disponibles pour le jour considéré. |
|---|
| 602 | | Le nom de cette variable dépend du paramÚtre |
|---|
| 603 | | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| 604 | | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| 605 | | ``foo_list``. |
|---|
| | 700 | ``day`` |
|---|
| | 701 | Un objet ``datetime.date`` représentant le jour considéré. |
|---|
| | 702 | |
|---|
| | 703 | ``next_day`` |
|---|
| | 704 | Un objet ``datetime.date`` représentant le jour suivant. |
|---|
| | 705 | Si le jour suivant est dans le futur, vaudra ``None``. |
|---|
| | 706 | |
|---|
| | 707 | ``previous_day`` |
|---|
| | 708 | Un objet ``datetime.date`` représentant le jour |
|---|
| | 709 | précédent. Contrairement à ``next_day``, ne vaudra jamais ``None``. |
|---|
| | 710 | |
|---|
| | 711 | ``object_list`` |
|---|
| | 712 | Une liste d'objets disponibles pour le jour considéré. |
|---|
| | 713 | Le nom de cette variable dépend du paramÚtre |
|---|
| | 714 | ``template_object_name``, qui est ``object`` par défaut. Si |
|---|
| | 715 | ``template_object_name`` est ``foo``, le nom de la variable sera |
|---|
| | 716 | ``foo_list``. |
|---|
| 626 | | **ParamÚtres requis :** |
|---|
| 627 | | |
|---|
| 628 | | * ``year``: l'année de l'objet (une chaîne de 4 chiffres). |
|---|
| 629 | | |
|---|
| 630 | | * ``month``: le mois de l'objet, au format indiqué |
|---|
| 631 | | par le paramÚtre ``month_format``. |
|---|
| 632 | | |
|---|
| 633 | | * ``day``: le jour de l'objet, au format indiqué |
|---|
| 634 | | par le paramÚtre ``day_format``. |
|---|
| 635 | | |
|---|
| 636 | | * ``queryset``: un ``QuerySet`` de l'objet à renvoyer dans l'archive. |
|---|
| 637 | | |
|---|
| 638 | | * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans |
|---|
| 639 | | le modÚle de ``QuerySet`` que la vue générique doit utiliser pour |
|---|
| 640 | | déterminer l'objet à renvoyer en fonction de ``year``, ``month`` et |
|---|
| 641 | | ``day``. |
|---|
| 642 | | |
|---|
| 643 | | * Soit ``object_id``, soit (``slug`` *et* ``slug_field``) sont requis. |
|---|
| 644 | | |
|---|
| 645 | | Si ``object_id`` est fourni, ce doit être la valeur du champ de clé |
|---|
| 646 | | primaire pour l'objet affiché sur la page. |
|---|
| 647 | | |
|---|
| 648 | | Sinon, ``slug`` doit être le slug de l'objet choisi, et ``slug_field`` |
|---|
| 649 | | doit être le nom du champ slug dans le modÚle de ``QuerySet``. La valeur |
|---|
| 650 | | par défaut de ``slug_field`` est ``'slug'``. |
|---|
| 651 | | |
|---|
| 652 | | **ParamÚtres optionnels :** |
|---|
| 653 | | |
|---|
| 654 | | * ``month_format``: une chaîne de format qui indique celui qui doit être |
|---|
| 655 | | utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée |
|---|
| 656 | | par la fonction Python ``time.strftime``. (Voir la `documentation de |
|---|
| 657 | | strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois |
|---|
| 658 | | abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez |
|---|
| 659 | | ``"%m"``. |
|---|
| 660 | | |
|---|
| 661 | | * ``day_format``: comme ``month_format``, mais pour le paramÚtre ``day``. |
|---|
| 662 | | La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). |
|---|
| 663 | | |
|---|
| 664 | | * ``template_name``: le nom complet du template à utiliser pour rendre la |
|---|
| 665 | | page. Cela permet de passer outre le nom du template par défaut (voir |
|---|
| 666 | | ci-dessous). |
|---|
| 667 | | |
|---|
| 668 | | * ``template_name_field``: le nom d'un champ de l'objet dont la valeur est |
|---|
| 669 | | le nom du template à utiliser. Cela vous permet de stocker le nom du |
|---|
| 670 | | template dans les données. En d'autres termes, si votre objet a un champ |
|---|
| 671 | | appelé ``'the_template'`` qui contient la chaîne ``'foo.html'``, et si |
|---|
| 672 | | vous positionnez ``template_name_field`` Ã la valeur ``'the_template'``, |
|---|
| 673 | | la vue générique de votre objet utilisera le template ``'foo.html'``. |
|---|
| 674 | | |
|---|
| 675 | | Ãa fait un peu mal à la tête, mais c'est parfois utile. |
|---|
| 676 | | |
|---|
| 677 | | * ``template_loader``: le chargeur de template à utiliser pour charger le |
|---|
| 678 | | template. Par défaut, c'est ``django.template.loader``. |
|---|
| 679 | | |
|---|
| 680 | | * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du |
|---|
| 681 | | template. Par défaut, c'est un dictionnaire vide. Si une valeur du |
|---|
| 682 | | dictionnaire est appelable (callable), la vue générique l'appellera |
|---|
| 683 | | juste avant le rendu du template. |
|---|
| 684 | | |
|---|
| 685 | | * ``context_processors``: une liste de processeurs de contexte de template |
|---|
| 686 | | Ã appliquer au template de la vue. Voir la `documentation de |
|---|
| 687 | | RequestContext`_. |
|---|
| 688 | | |
|---|
| 689 | | * ``template_object_name``: indique le nom de la variable de template à |
|---|
| 690 | | utiliser dans le contexte du template. Par défaut, c'est ``object``. |
|---|
| 691 | | |
|---|
| 692 | | * ``mimetype``: le type MIME à utiliser pour le document résultant. La |
|---|
| 693 | | valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. |
|---|
| 694 | | |
|---|
| 695 | | * ``allow_futur |
|---|