django-loci 1.1

无法加载SpatiaLite库扩展

如果您遇到以下异常

django.core.exceptions.ImproperlyConfigured: Unable to load the SpatiaLite library extension

您需要在settings.py中指定SPATIALITE_LIBRARY_PATH，如django关于如何安装和配置spatialte的文档中所述。

与其他地理空间库的问题

请参考GeoDjango关于解决与地理空间库相关问题的文档。

LOCI_FLOORPLAN_STORAGE

用于上传平面图图像的django文件存储类。

只要文件存储有upload_to类方法，它就会被传递给FloorPlan.image.upload_to，您就可以将其更改为不同的存储。

要了解此语句的详细信息，请查看django_loci.storage.OverwriteStorage的代码。

DJANGO_LOCI_GEOCODER

用于地理编码和反向地理编码的服务。

支持的地理位置服务

• ArcGIS

• Nominatim

• GoogleV3 (Google Maps v3)

DJANGO_LOCI_GEOCODE_FAILURE_DELAY

地理编码请求失败时，在重试API调用之间等待的秒数。

DJANGO_LOCI_GEOCODE_RETRIES

地理编码请求失败时的重试API调用次数。

DJANGO_LOCI_GEOCODE_API_KEY

如果需要，请提供API密钥（例如：Google Maps）。

扩展模型

以下示例展示了如何通过添加对名为Organization的另一个django模型的引用来扩展django-loci的基模型。

# models.py of your app
from django.db import models
from django_loci.base.models import (
    AbstractFloorPlan,
    AbstractLocation,
    AbstractObjectLocation,
)

# the model ``organizations.Organization`` is omitted for brevity
# if you are curious to see a real implementation, check out django-organizations


class OrganizationMixin(models.Model):
    organization = models.ForeignKey("organizations.Organization")

    class Meta:
        abstract = True


class Location(OrganizationMixin, AbstractLocation):
    class Meta(AbstractLocation.Meta):
        abstract = False

    def clean(self):
        # your own validation logic here...
        pass


class FloorPlan(OrganizationMixin, AbstractFloorPlan):
    location = models.ForeignKey(Location)

    class Meta(AbstractFloorPlan.Meta):
        abstract = False

    def clean(self):
        # your own validation logic here...
        pass


class ObjectLocation(OrganizationMixin, AbstractObjectLocation):
    location = models.ForeignKey(
        Location, models.PROTECT, blank=True, null=True
    )
    floorplan = models.ForeignKey(
        FloorPlan, models.PROTECT, blank=True, null=True
    )

    class Meta(AbstractObjectLocation.Meta):
        abstract = False

    def clean(self):
        # your own validation logic here...
        pass

扩展管理界面

在先前的Organization示例中，您可以通过导入基admin类并使用它们注册模型来避免重复admin代码。

但首先，您需要在您的settings.py中更改一些设置，这些设置对于在settings.INSTALLED_APPS中未列出的情况下加载django-loci的admin模板和静态文件是必需的。

将django.forms添加到INSTALLED_APPS，现在它应该看起来像以下这样

INSTALLED_APPS = [
    # ...
    "django.contrib.gis",
    "django_loci",
    "django.contrib.admin",
    #      ↓
    "django.forms",  # <-- add this
    #      ↑
    "leaflet",
    "channels"
    # ...
]

现在在INSTALLED_APPS之后添加EXTENDED_APPS

INSTALLED_APPS = [
    # ...
]

EXTENDED_APPS = ("django_loci",)

将openwisp_utils.staticfiles.DependencyFinder添加到STATICFILES_FINDERS

STATICFILES_FINDERS = [
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
    "openwisp_utils.staticfiles.DependencyFinder",
]

将openwisp_utils.loaders.DependencyLoader添加到TEMPLATES

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [],
        "OPTIONS": {
            "loaders": [
                "django.template.loaders.filesystem.Loader",
                "django.template.loaders.app_directories.Loader",
                # add the following line
                "openwisp_utils.loaders.DependencyLoader",
            ],
            "context_processors": [
                "django.template.context_processors.debug",
                "django.template.context_processors.request",
                "django.contrib.auth.context_processors.auth",
                "django.contrib.messages.context_processors.messages",
            ],
        },
    }
]

最后一步，添加FORM_RENDERER

FORM_RENDERER = "django.forms.renderers.TemplatesSetting"

然后您可以根据以下示例创建您的admin.py文件

# admin.py of your app
from django.contrib import admin

from django_loci.base.admin import (
    AbstractFloorPlanAdmin,
    AbstractFloorPlanForm,
    AbstractFloorPlanInline,
    AbstractLocationAdmin,
    AbstractLocationForm,
    AbstractObjectLocationForm,
    AbstractObjectLocationInline,
)
from django_loci.models import FloorPlan, Location, ObjectLocation


class FloorPlanForm(AbstractFloorPlanForm):
    class Meta(AbstractFloorPlanForm.Meta):
        model = FloorPlan


class FloorPlanAdmin(AbstractFloorPlanAdmin):
    form = FloorPlanForm


class LocationForm(AbstractLocationForm):
    class Meta(AbstractLocationForm.Meta):
        model = Location


class FloorPlanInline(AbstractFloorPlanInline):
    form = FloorPlanForm
    model = FloorPlan


class LocationAdmin(AbstractLocationAdmin):
    form = LocationForm
    inlines = [FloorPlanInline]


class ObjectLocationForm(AbstractObjectLocationForm):
    class Meta(AbstractObjectLocationForm.Meta):
        model = ObjectLocation


class ObjectLocationInline(AbstractObjectLocationInline):
    model = ObjectLocation
    form = ObjectLocationForm


admin.site.register(FloorPlan, FloorPlanAdmin)
admin.site.register(Location, LocationAdmin)

扩展通道消费者

以这种方式扩展django-loci的channel consumer

from django_loci.channels.base import BaseLocationBroadcast
from ..models import Location  # your own location model


class LocationBroadcast(BaseLocationBroadcast):
    model = Location

扩展AppConfig

您可能还想重用django-loci的AppConfig类

from django_loci.apps import LociConfig


class MyConfig(LociConfig):
    name = "myapp"
    verbose_name = _("My custom app")

    def __setmodels__(self):
        from .models import Location

        self.location_model = Location