معرفی شرکت ها
django-json-ld-0.0.5
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Django template tag for json-ld
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-json-ld-0.0.5 |
| نام | django-json-ld |
| نسخه کتابخانه | 0.0.5 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Johnny Chang |
| ایمیل نویسنده | hiimdoublej@gmail.com |
| آدرس صفحه اصلی | https://github.com/hiimdoublej/django-json-ld |
| آدرس اینترنتی | https://pypi.org/project/django-json-ld/ |
| مجوز | - |
# django-json-ld
This is a django template tag to help developers render [structured data](https://developers.google.com/search/docs/guides/intro-structured-data) tags inside their django templates.
Furthermore a collection of views and mixins are included:
* `JsonLdContextMixin`, `JsonLdView`
* `JsonLdSingleObjectMixin`, `JsonLdDetailView`
## Installation
Install using `pip`:
```
pip install django-json-ld
```
Add `django_json_ld` to `INSTALLED_APPS` in `settings.py`:
```
INSTALLED_APPS = [
# Other apps...
'django_json_ld',
]
```
## Settings
You can override the following options in settings.py:
`JSON_LD_CONTEXT_ATTRIBUTE`: the context attribute name used in `django_json_ld`'s Class-Based Views (CBV). Defaults to `'sd'`.
`JSON_LD_MODEL_ATTRIBUTE`: the model attribute name used by `JsonLdDetailView` to get the model's structured data. Defaults to `'sd'`.
`JSON_LD_DEFAULT_CONTEXT`: default json-ld context when using `django_json_ld`'s CBVs. Defaults to `'https://schema.org/'`.
`JSON_LD_INDENT`: indent are used by `json.dumps` function to prettify output. Valid values are `None` or a non-negative integer. Defaults to `None` - outputs on a single line. This setting is used only if ``DEBUG`` is ``True``
`JSON_LD_DEFAULT_TYPE`: default json-ld type when using `django_json_ld`'s CBVs. Defaults to `'Thing'`.
`JSON_LD_GENERATE_URL`: generate json-ld's `url` field when using `django_json_ld`'s CBVs. Defaults to `True`.
`JSON_LD_EMPTY_INPUT_RENDERING`: behavior when the template tag receives an empty object. Possible values:
* `strict` default, raise TemplateSyntaxError.
* `silent` renders nothing.
* `generate_thing` creates object with URL of current page. eg:
```
structured_data = {
"@context": <JSON_LD_DEFAULT_CONTEXT>,
"@type": <JSON_LD_DEFAULT_TYPE>,
"url": <current_page_url>,
}
```
## Usage Example
Assuming you have a structured data `sd` like the following in your context (copied from the link above).
```
sd = {
"@context": "https://schema.org/",
"@type": "Organization",
"url": "http://www.example.com/",
"name": "Unlimited Ball Bearings Corp.",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+1-401-555-1212",
"contactType": "Customer service"
}
}
```
Then, in your template:
```
{% load render_json_ld from json_ld %}
{% render_json_ld sd %}
```
Would render into:
```
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Organization",
"url": "http://www.example.com/",
"name": "Unlimited Ball Bearings Corp.",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+1-401-555-1212",
"contactType": "Customer service"
}
}
</script>
```
### Class-Based View example
#### Simple View
views.py
```python
from django_json_ld.views import JsonLdContextMixin
class HomeView(JsonLdContextMixin, generic.ListView):
structured_data = {
"@type": "Organization",
"name": "The Company",
"description": _("A great company."),
}
def get_structured_data(self):
structured_data = super(HomeView, self).get_structured_data()
structured_data["event"] = get_next_event()
return structured_data
```
By using `{% render_json_ld sd %}`, as explained in the previous example, would render into something like:
```json
{
"@context":"https://schema.org/",
"@type":"Organization",
"name":"The Company",
"description":"Uma grande empresa.",
"url":"http://example.org/",
"event": {
"@type": "Event",
"about": ["Hodler","Monet","Munch"],
"name": "Peindre l'impossible",
"startDate": "2016-09-15",
"endDate": "2017-01-22"
}
}
```
In the above example `JsonLdContextMixin` adds `sd` to `HomeView`'s context.
`django_json_ld` supports lazy translations, hence `"description"` showing the translated version of its original value.
#### Detail View
views.py
```python
from django_json_ld.views import JsonLdDetailView
class ProductDetailView(JsonLdDetailView):
model=Product
```
models.py
```python
class Product(models.Model):
name = models.CharField(_('Name'), max_length=255)
description = models.TextField(_('Description'))
@property
def sd(self):
return {
"@type": 'Product',
"description": self.description,
"name": self.name,
}
```
By using `{% render_json_ld sd %}`, as explained previously, would render into something like:
```json
{
"@context":"https://schema.org/",
"@type":"Product",
"name":"The Product",
"description":"A great product.",
"url":"http://example.org/products/1/the-product/"
}
```
In the above example `JsonLdDetailView` adds `sd` to `ProductDetailView`'s context, using `Product`'s own `sd` property. The `url` is generated automatically by `JsonLdDetailView`. This behaviour is configurable through settings.
نحوه نصب
نصب پکیج whl django-json-ld-0.0.5:
pip install django-json-ld-0.0.5.whl
نصب پکیج tar.gz django-json-ld-0.0.5:
pip install django-json-ld-0.0.5.tar.gz