pretix-map 0.0.3__py3-none-any.whl

pretix_map-0.0.3.dist-info/METADATA

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: pretix-map
+Version: 0.0.3
+Summary: An overview map of the catchment area of previous orders. Measured by postcode
+Author-email: MarkenJaden <jjsch1410@gmail.com>
+Maintainer-email: MarkenJaden <jjsch1410@gmail.com>
+License: Apache
+Project-URL: homepage, https://github.com/MarkenJaden/pretix-map
+Project-URL: repository, https://github.com/MarkenJaden/pretix-map
+Keywords: pretix
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: geopy
+Dynamic: license-file
+
+Map-Plugin
+==========================
+
+This is a plugin for `pretix`_.
+
+It provides an overview map visualizing the geographic location of attendees based on the addresses provided in their orders. The plugin automatically geocodes order addresses upon payment and displays the locations on an interactive map within the event control panel.
+
+Features:
+
+*   Automatic geocoding of paid order addresses using a configured geocoding service.
+*   Interactive map display (Leaflet) showing locations as clustered pins or a heatmap.
+*   Option to toggle between pin view and heatmap view.
+*   Pins show tooltips with Order Code, Date, and Item Count on hover.
+*   Clicking a pin navigates directly to the corresponding order details page.
+*   Adds a "Sales Map" link to the event navigation sidebar.
+*   Includes a management command to geocode orders placed *before* the plugin was installed or configured.
+
+Requirements
+------------
+
+*   A working `pretix installation`_.
+*   A **Celery worker** configured and running for your Pretix instance. This is essential for the background geocoding tasks.
+*   Access to a **Geocoding Service**. This plugin requires configuration to use an external service to convert addresses to latitude/longitude coordinates. See the **Configuration** section below.
+
+
+Installation (Production)
+--------------------------
+
+1.  Ensure you meet the requirements above, especially a running Celery worker.
+2.  Activate the virtual environment used for your Pretix installation.
+3.  Install the plugin via pip:
+
+    .. code-block:: bash
+
+        pip install pretix-map-plugin
+
+    *(Note: If the plugin is not on PyPI yet, you might need to install from the git repository URL)*
+4.  Configure the required geocoding service settings in your `pretix.cfg` file (see **Configuration** below).
+5.  Restart your Pretix webserver (`gunicorn`/`uwsgi`) **and** your Pretix Celery worker(s).
+6.  Log in to your Pretix backend and go to Organizer Settings -> Plugins. Enable the "Sales Map" plugin for the desired organizer(s).
+7.  Go into an event, then navigate to Event Settings -> Plugins and ensure the "Sales Map" plugin is checked (enabled) for that event.
+
+
+Configuration (`pretix.cfg`)
+------------------------------
+
+This plugin requires configuration in your `pretix.cfg` file to specify which geocoding service to use. Add a section `[pretix_mapplugin]` if it doesn't exist.
+
+**Required Setting (Choose ONE method):**
+
+*   **Method 1: Nominatim (OpenStreetMap - Free, Requires User-Agent)**
+    Nominatim is a free geocoding service based on OpenStreetMap data. It has usage policies that **require** you to set a descriptive User-Agent header, typically including your application name and contact email. Failure to do so may result in your IP being blocked.
+
+    .. code-block:: ini
+
+        [pretix_mapplugin]
+        # REQUIRED for Nominatim: Set a descriptive User-Agent including application name and contact info.
+        # Replace with your actual details! See: https://operations.osmfoundation.org/policies/nominatim/
+        nominatim_user_agent=YourTicketingSite/1.0 (Contact: admin@yourdomain.com) pretix-map-plugin/1.0
+
+*   **Method 2: Other Geocoding Services (e.g., Google, Mapbox - API Key likely needed)**
+    *(This example assumes you have modified `tasks.py` to use a different geocoder like GeoPy with GoogleV3. Adjust the setting name and value based on your implementation.)*
+
+    .. code-block:: ini
+
+        [pretix_mapplugin]
+        # Example for Google Geocoding API (if implemented in tasks.py)
+        # google_geocoding_api_key=YOUR_GOOGLE_GEOCODING_API_KEY
+
+**Important:** After adding or changing settings in `pretix.cfg`, you **must restart** the Pretix webserver and Celery workers for the changes to take effect.
+
+Usage
+-----
+
+1.  Once installed, configured, and enabled, the plugin works mostly automatically.
+2.  When an order is marked as paid, a background task is queued to geocode the address associated with the order (typically the invoice address). This requires your Celery worker to be running.
+3.  A "Sales Map" link will appear in the event control panel's sidebar navigation (usually near other order-related items or plugin links) for users with the "Can view orders" permission.
+4.  Clicking this link displays the map. You can toggle between the pin view (markers clustered) and the heatmap view using the button provided.
+5.  In the pin view:
+
+    *   Hover over a marker cluster to see the number of orders it represents.
+    *   Zoom in to break clusters apart.
+    *   Hover over an individual pin to see a tooltip with Order Code, Date, and Item Count.
+    *   Click an individual pin to open the corresponding order details page in a new tab.
+
+Management Command: `geocode_existing_orders`
+---------------------------------------------
+
+This command is essential for processing orders that were placed *before* the map plugin was installed, enabled, or correctly configured with geocoding credentials. It scans paid orders and queues geocoding tasks for those that haven't been geocoded yet.
+
+**When to Run:**
+
+*   After installing and configuring the plugin for the first time.
+*   If you previously ran the plugin without a working geocoding configuration or Celery worker.
+*   If you want to force-reprocess orders (e.g., if geocoding logic changed).
+
+**Prerequisites:**
+
+*   Your Pretix Celery worker **must** be running to process the tasks queued by this command.
+*   Geocoding settings must be correctly configured in `pretix.cfg`.
+
+**How to Run:**
+
+1.  Navigate to your Pretix installation directory (containing `manage.py`) in your server terminal.
+2.  Activate your Pretix virtual environment.
+3.  Execute the command using `manage.py`.
+
+**Basic Command:**
+
+.. code-block:: bash
+
+    python manage.py geocode_existing_orders [options]
+
+**Available Options:**
+
+*   `--organizer <slug>`: Process orders only for the organizer with the given slug.
+    *   Example: `python manage.py geocode_existing_orders --organizer=myorg`
+*   `--event <slug>`: Process orders only for the event with the given slug. **Requires** `--organizer` to be specified as well.
+    *   Example: `python manage.py geocode_existing_orders --organizer=myorg --event=myevent2024`
+*   `--dry-run`: **Highly Recommended for first use!** Simulates the process and shows which orders *would* be queued, but doesn't actually queue any tasks. Use this to verify the scope and count before running for real.
+    *   Example: `python manage.py geocode_existing_orders --dry-run`
+*   `--force-recode`: Queues geocoding tasks even for orders that already have an entry in the geocoding data table. Use this if you suspect previous geocoding attempts were incomplete or incorrect, or if the geocoding logic has been updated.
+    *   Example: `python manage.py geocode_existing_orders --organizer=myorg --force-recode`
+
+**Example Workflow:**
+
+1.  **Test with Dry Run (All Organizers):**
+    .. code-block:: bash
+
+        python manage.py geocode_existing_orders --dry-run
+2.  **(If satisfied) Run for Real (All Organizers):**
+    .. code-block:: bash
+
+        python manage.py geocode_existing_orders
+3.  **Monitor your Celery worker** logs to ensure tasks are being processed without errors.
+
+
+Development setup
+-----------------
+
+1. Make sure that you have a working `pretix development setup`_. Ensure your dev setup includes a running Celery worker if you want to test the background tasks.
+2. Clone this repository.
+3. Activate the virtual environment you use for pretix development.
+4. Execute ``python setup.py develop`` within this directory to register this application with pretix's plugin registry.
+5. Execute ``make`` within this directory to compile translations.
+6. **Configure Geocoding:** Add the necessary geocoding settings (e.g., `nominatim_user_agent`) to your local `pretix.cfg` file for testing the geocoding feature.
+7. Restart your local pretix server and Celery worker. You can now use the plugin from this repository for your events by enabling it in the 'plugins' tab in the settings.
+
+This plugin has CI set up to enforce a few code style rules. To check locally, you need these packages installed::
+
+    pip install flake8 isort black
+
+To check your plugin for rule violations, run::
+
+    black --check .
+    isort -c .
+    flake8 .
+
+You can auto-fix some of these issues by running::
+
+    isort .
+    black .
+
+To automatically check for these issues before you commit, you can run ``.install-hooks``.
+
+
+License
+-------
+
+Copyright 2025 MarkenJaden
+
+Released under the terms of the Apache License 2.0
+
+
+
+.. _pretix: https://github.com/pretix/pretix
+.. _pretix installation: https://docs.pretix.eu/en/latest/administrator/installation/index.html
+.. _pretix development setup: https://docs.pretix.eu/en/latest/development/setup.html

pretix_map-0.0.3.dist-info/RECORD

@@ -0,0 +1,45 @@
+pretix_map-0.0.3.dist-info/licenses/LICENSE,sha256=RhQ89ePNDClBzEROahhwjDrBSEb5Zpx6XewZfGlY4Ss,569
+pretix_mapplugin/__init__.py,sha256=4dCrvStS1OgE3Vlcv-qx5-TAo377yOMEToEqCi-PwY4,23
+pretix_mapplugin/apps.py,sha256=AnThwyRw2AAz5f-kmXZ8hm85OmKnlDkRosVoQOBgPzE,830
+pretix_mapplugin/geocoding.py,sha256=pZUF8pJ5mOFoNT1foRNuhCJO1XkJ8040AA9qIjrP8JI,4631
+pretix_mapplugin/models.py,sha256=v0v9K0sb5OQHs5Gc6-jea_aEGECUQp1tZoYMwwb3YIM,994
+pretix_mapplugin/signals.py,sha256=qUcM50bbHBET75ysI2C0UB7-969LjpLGRLeRLqm4sQo,3036
+pretix_mapplugin/tasks.py,sha256=1y4IExpOWkepDVDaKOw9OgHUgLmPpmO6sN8Z8L-sB90,3590
+pretix_mapplugin/urls.py,sha256=o5407vULF4S-bUihU7AeRxUcMyazg2lPjbvqRflsGxE,838
+pretix_mapplugin/views.py,sha256=7WgmNZeqwmOesT6PrkAIRC8fNfAcWGm-j9-2YqF5egI,7146
+pretix_mapplugin/locale/de/LC_MESSAGES/django.mo,sha256=6VVRAqa0ixL-lDA1QwoVvG0wd5ZBwYjaR4P8T73hxhU,269
+pretix_mapplugin/locale/de/LC_MESSAGES/django.po,sha256=tIFKw9KOdGTjGq8bHV6tquRZe_MOn8TT4MJjdTRhId8,323
+pretix_mapplugin/locale/de_Informal/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/locale/de_Informal/LC_MESSAGES/django.mo,sha256=6VVRAqa0ixL-lDA1QwoVvG0wd5ZBwYjaR4P8T73hxhU,269
+pretix_mapplugin/locale/de_Informal/LC_MESSAGES/django.po,sha256=tIFKw9KOdGTjGq8bHV6tquRZe_MOn8TT4MJjdTRhId8,323
+pretix_mapplugin/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/management/commands/geocode_existing_orders.py,sha256=pvGwC1j6NzSf2Y7r-Lk_-6c7YsgqLr-NCu0HT5VLaeY,8407
+pretix_mapplugin/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/static/pretix_mapplugin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/static/pretix_mapplugin/css/salesmap.css,sha256=z-OXFjpGWOoxv_tlYSDSUlcFLU9p03hhXI-8yxExl3k,598
+pretix_mapplugin/static/pretix_mapplugin/js/salesmap.js,sha256=zKSWlJp96VCt6PFVuw5xV8jA-yCyWDG1Vj94Vq7hQlA,16941
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/MarkerCluster.Default.css,sha256=LWhzWaQGZRsWFrrJxg-6Zn8TT84k0_trtiHBc6qcGpY,1346
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/MarkerCluster.css,sha256=-bdWuWOXMFkX0v9Cvr3OWClPiYefDQz9GGZP_7xZxdc,886
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet-heat.js,sha256=aPb_2lnWKnXsUc1_-aT9-kbtr4CV3c85jH9xC1e5QDI,5168
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet-src.esm.js,sha256=i7N_sDD-OoSdbNWYx4paYveaHkkprfXimr67-kGDy_M,430058
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet-src.esm.js.map,sha256=lxY34ye1PfsolFQ8pTsEtlgBJ4tW7panCBRsm35HNbs,866200
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet-src.js,sha256=Y0Ki5d8X0X1H2YiS590G4GgQTUnf6kP26s5XsJ2w76Q,455791
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet-src.js.map,sha256=l7cBxd_w6YZOXEWKixXC7DN4ejJsXed7kI-eoTvi1Wo,866292
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet.css,sha256=p4NxAoJBhIIN-hmNHrzRCf9tD_miZyoHS5obTRR9BMY,14806
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet.js,sha256=MQS1JlBNDWH9MJmkUh6H9zLMwxdN7FTgjea6i94-Ff8,147557
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet.js.map,sha256=YAoQ3FzREN4GmVENMir8vgHHypC0xfSK3CAxTHCqx1M,225544
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet.markercluster.js,sha256=WxJnsgS9OQGt16B_czxdDIl7Am9bwYkpj0eYwRE-Cy4,33726
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/leaflet.markercluster.js.map,sha256=R8juz3AGnE2aOl3MIx1ram0tNMMiec7EPYwDbqb2ycc,27636
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/images/layers-2x.png,sha256=Bm2sqFDY_77wB68AsG6sABVyje4nnFHzy2xxbffELt8,1259
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/images/layers.png,sha256=Hbvp0CjikvNvy6j4s6KNXokydU_CIVuaxp5M3s9RB8Y,696
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/images/marker-icon-2x.png,sha256=ABecTB7oMNOhCEEq4NKU9Vd2z-sIXGASmjmqb8SuJSg,2464
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/images/marker-icon.png,sha256=V0w6XMqF9BFAhbaEFZbWLwDXyJLHsD8oy_owHesdxDc,1466
+pretix_mapplugin/static/pretix_mapplugin/libs/leaflet-sales-map/images/marker-shadow.png,sha256=Jk9cZAM58ELdcpBiz8BMF_jqDymIK1OOOEjtjxDttNo,618
+pretix_mapplugin/templates/pretix_mapplugin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pretix_mapplugin/templates/pretix_mapplugin/map_page.html,sha256=jUfPrCkwcbcTXgZ2d9a5wpUD1U7Y8g5rnB20hklKQ-k,2252
+pretix_map-0.0.3.dist-info/METADATA,sha256=79Rqjxe9HVOOcz34UYPrC3vmNJEDtqRu1ck6CEyhI-o,9514
+pretix_map-0.0.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+pretix_map-0.0.3.dist-info/entry_points.txt,sha256=C3NAjeZHoCekafkLMCJynPcABRTK8AUprtQv7sUNDZs,137
+pretix_map-0.0.3.dist-info/top_level.txt,sha256=CAtEnkgA73zE9Gadm5mjt1SpXHBPOS-QWP0dQVoNToE,17
+pretix_map-0.0.3.dist-info/RECORD,,

pretix_map-0.0.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (78.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pretix_map-0.0.3.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[distutils.commands]
+build = pretix_plugin_build.build:CustomBuild
+
+[pretix.plugin]
+pretix_mapplugin = pretix_mapplugin:PretixPluginMeta

pretix_map-0.0.3.dist-info/licenses/LICENSE

@@ -0,0 +1,15 @@
+
+Copyright 2025 MarkenJaden
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

pretix_map-0.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+pretix_mapplugin

pretix_mapplugin/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.3"

pretix_mapplugin/apps.py

@@ -0,0 +1,28 @@
+from django.utils.translation import gettext_lazy
+
+from . import __version__
+
+try:
+    from pretix.base.plugins import PluginConfig
+except ImportError:
+    raise RuntimeError("Please use pretix 2.7 or above to run this plugin!")
+
+
+class PluginApp(PluginConfig):
+    default = True
+    name = "pretix_mapplugin"
+    verbose_name = "Map-Plugin"
+
+    class PretixPluginMeta:
+        name = gettext_lazy("Map-Plugin")
+        author = "MarkenJaden"
+        description = gettext_lazy("An overview map of the catchment area of previous orders. Measured by postcode")
+        visible = True
+        version = __version__
+        category = "FEATURE"
+        compatibility = "pretix>=2.7.0"
+        settings_links = []
+        navigation_links = []
+
+    def ready(self):
+        from . import signals  # NOQA

pretix_mapplugin/geocoding.py

@@ -0,0 +1,113 @@
+import logging
+
+# --- Import Django settings ---
+from django.conf import settings
+from geopy.exc import GeocoderServiceError, GeocoderTimedOut
+from geopy.geocoders import Nominatim
+from time import sleep
+
+# Configure logging for your plugin
+logger = logging.getLogger(__name__)
+
+# --- Configuration Default ---
+# Define a default/fallback User-Agent. Users *should* override this in pretix.cfg.
+DEFAULT_NOMINATIM_USER_AGENT = "pretix-map-plugin/unknown (Please configure nominatim_user_agent in pretix.cfg)"
+
+
+# --- Geocoding Function ---
+
+def geocode_address(address_string: str) -> tuple[float, float] | None:
+    """
+    Tries to geocode a given address string using Nominatim, reading the
+    User-Agent from Pretix configuration.
+
+    Args:
+        address_string: A single string representing the address.
+
+    Returns:
+        A tuple (latitude, longitude) if successful, otherwise None.
+    """
+    # --- Get User-Agent from Pretix Settings ---
+    # Access plugin settings via settings.plugins.<your_plugin_name>
+    # The .get() method allows providing a default value if the setting is missing.
+    user_agent = settings.plugins.pretix_mapplugin.get(
+        'nominatim_user_agent',  # The setting name defined in pretix.cfg
+        DEFAULT_NOMINATIM_USER_AGENT
+    )
+
+    # Log a warning if the default User-Agent is being used, as it's required
+    # by Nominatim policy to be specific and include contact info.
+    if user_agent == DEFAULT_NOMINATIM_USER_AGENT:
+        logger.warning(
+            "Using default Nominatim User-Agent. Please set a specific "
+            "'nominatim_user_agent' under [pretix_mapplugin] in your "
+            "pretix.cfg according to Nominatim's usage policy."
+        )
+    # --- End Settings Retrieval ---
+
+    # Initialize the geolocator with the configured or default user_agent
+    geolocator = Nominatim(user_agent=user_agent)
+
+    try:
+        # Add a 1-second delay to respect Nominatim's usage policy (1 req/sec)
+        sleep(1)
+
+        location = geolocator.geocode(address_string, timeout=10)
+
+        if location:
+            logger.debug(
+                f"Geocoded '{address_string}' to ({location.latitude}, {location.longitude}) using User-Agent: {user_agent}")
+            return (location.latitude, location.longitude)
+        else:
+            logger.warning(f"Could not geocode address: {address_string} (Address not found by Nominatim)")
+            return None
+
+    except GeocoderTimedOut:
+        logger.error(f"Geocoding timed out for address: {address_string}")
+        return None
+    except GeocoderServiceError as e:
+        logger.error(f"Geocoding service error for address '{address_string}': {e}")
+        return None
+    except Exception as e:
+        logger.exception(f"An unexpected error occurred during geocoding for address '{address_string}': {e}")
+        return None
+
+
+# --- Helper to Format Address from Pretix Order (No changes needed here) ---
+
+def get_formatted_address_from_order(order) -> str | None:
+    """
+    Creates a formatted address string from a Pretix order's invoice address.
+    """
+    if not order.invoice_address:
+        return None
+    parts = []
+    if order.invoice_address.street: parts.append(order.invoice_address.street)
+    if order.invoice_address.city: parts.append(order.invoice_address.city)
+    if order.invoice_address.zipcode: parts.append(order.invoice_address.zipcode)
+    if order.invoice_address.state: parts.append(order.invoice_address.state)
+    if order.invoice_address.country: parts.append(str(order.invoice_address.country.name))
+    if not parts: return None
+    full_address = ", ".join(filter(None, parts))
+    return full_address
+
+
+# --- Example Usage (Conceptual - No changes needed here) ---
+# This function itself isn't called directly, the logic is in tasks.py
+def process_order_for_geocoding(order):
+    """Conceptual function showing how to use the geocoding."""
+    address_str = get_formatted_address_from_order(order)
+    if not address_str:
+        logger.info(f"Order {order.code} has no invoice address to geocode.")
+        return None
+
+    coordinates = geocode_address(address_str)  # This now uses the configured User-Agent
+
+    if coordinates:
+        latitude, longitude = coordinates
+        logger.info(f"Successfully geocoded Order {order.code}: ({latitude}, {longitude})")
+        # Store coordinates...
+        return coordinates
+    else:
+        logger.warning(f"Failed to geocode Order {order.code} with address: {address_str}")
+        return None

pretix_mapplugin/locale/de/LC_MESSAGES/django.po

@@ -0,0 +1,12 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2017-03-07 19:01+0100\n"
+"PO-Revision-Date: \n"
+"Last-Translator: MarkenJaden\n"
+"Language-Team: \n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"

pretix_mapplugin/locale/de_Informal/LC_MESSAGES/django.po

@@ -0,0 +1,12 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2017-03-07 19:01+0100\n"
+"PO-Revision-Date: \n"
+"Last-Translator: MarkenJaden\n"
+"Language-Team: \n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"

pretix_mapplugin/management/commands/geocode_existing_orders.py

@@ -0,0 +1,167 @@
+import logging
+from django.core.exceptions import FieldDoesNotExist
+from django.core.management.base import BaseCommand, CommandError
+
+# Import scope activation helpers
+from django_scopes import scope
+
+# Import necessary Pretix models
+from pretix.base.models import Event, Order, Organizer
+
+# Import your Geocode model and the task
+from pretix_mapplugin.models import OrderGeocodeData
+from pretix_mapplugin.tasks import geocode_order_task
+
+logger = logging.getLogger(__name__)
+
+
+class Command(BaseCommand):
+    help = 'Scans paid orders and queues geocoding tasks for those missing geocode data.'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--organizer',
+            type=str,
+            help='Slug of a specific organizer to process orders for.',
+        )
+        parser.add_argument(
+            '--event',
+            type=str,
+            help='Slug of a specific event to process orders for. Requires --organizer.',
+        )
+        parser.add_argument(
+            '--dry-run',
+            action='store_true',
+            help='Simulate the process without actually queuing tasks.',
+        )
+        parser.add_argument(
+            '--force-recode',
+            action='store_true',
+            help='Queue geocoding even for orders that already have geocode data.',
+        )
+
+    def handle(self, *args, **options):
+        organizer_slug = options['organizer']
+        event_slug = options['event']
+        dry_run = options['dry_run']
+        force_recode = options['force_recode']
+
+        if event_slug and not organizer_slug:
+            raise CommandError("You must specify --organizer when using --event.")
+
+        # --- Determine which organizers to process ---
+        organizers_to_process = []
+        if organizer_slug:
+            try:
+                # Fetch specific organizer (outside scope)
+                organizer = Organizer.objects.get(slug=organizer_slug)
+                organizers_to_process.append(organizer)
+                self.stdout.write(f"Processing specified organizer: {organizer.name} ({organizer_slug})")
+            except Organizer.DoesNotExist:
+                raise CommandError(f"Organizer with slug '{organizer_slug}' not found.")
+        else:
+            # Fetch all organizers (outside scope)
+            organizers_to_process = list(Organizer.objects.all())
+            self.stdout.write(f"Processing all {len(organizers_to_process)} organizers...")
+
+        # --- Initialize counters ---
+        total_queued = 0
+        total_skipped = 0
+        total_processed_orders = 0  # Track how many orders were checked
+
+        # --- Iterate through organizers and activate scope ---
+        for organizer in organizers_to_process:
+            self.stdout.write(f"\n--- Processing Organizer: {organizer.name} ({organizer.slug}) ---")
+
+            # --- Activate scope for this organizer ---
+            with scope(organizer=organizer):
+                # --- Now perform queries WITHIN the scope ---
+
+                # Start with paid orders FOR THIS ORGANIZER
+                orders_qs = Order.objects.filter(status=Order.STATUS_PAID)
+
+                # Filter by specific Event if requested
+                if event_slug and organizer.slug == organizer_slug:  # Ensure we only filter for the specified org
+                    try:
+                        # Event query is now safe within organizer scope
+                        event = Event.objects.get(slug=event_slug)  # No need for organizer filter here
+                        orders_qs = orders_qs.filter(event=event)
+                        self.stdout.write(f"  Filtering orders for event: {event.name} ({event_slug})")
+                    except Event.DoesNotExist:
+                        # Don't raise CommandError, just report and skip event for this organizer
+                        self.stderr.write(self.style.WARNING(
+                            f"  Event '{event_slug}' not found for this organizer. Skipping event filter."))
+                        # If only this event was requested for this organizer, skip to next organizer
+                        if organizer_slug and event_slug:
+                            continue
+
+                # Filter orders needing geocoding (within scope)
+                if not force_recode:
+                    try:
+                        # Check relation name - REPLACE 'geocode_data' if yours is different
+                        relation_name = 'geocode_data'  # Change if necessary
+                        Order._meta.get_field(relation_name)
+                        orders_to_process_qs = orders_qs.filter(**{f'{relation_name}__isnull': True})
+                        self.stdout.write("  Selecting paid orders missing geocode data...")
+                    except FieldDoesNotExist:
+                        self.stderr.write(self.style.ERROR(
+                            f"  Could not find reverse relation '{relation_name}' on Order model. Check OrderGeocodeData model. Skipping organizer."))
+                        continue  # Skip this organizer if relation is wrong
+                    except Exception as e:
+                        self.stderr.write(
+                            self.style.ERROR(f"  Unexpected error checking relation: {e}. Skipping organizer."))
+                        continue
+                else:
+                    orders_to_process_qs = orders_qs
+                    self.stdout.write(self.style.WARNING(
+                        "  Processing ALL selected paid orders for this organizer (--force-recode)..."))
+
+                # Get count within scope
+                current_org_orders_count = orders_to_process_qs.count()
+                total_processed_orders += orders_qs.count()  # Count all checked orders for this org
+
+                if current_org_orders_count == 0:
+                    self.stdout.write("  No orders need geocoding for this organizer/event.")
+                    continue  # Skip to next organizer
+
+                self.stdout.write(f"  Found {current_org_orders_count} order(s) to potentially geocode.")
+                org_queued = 0
+                org_skipped = 0
+
+                # Iterate and queue (within scope)
+                for order in orders_to_process_qs.iterator():
+                    if dry_run:
+                        self.stdout.write(
+                            f"    [DRY RUN] Would queue Order: {order.code} (PK: {order.pk}) Event: {order.event.slug}")
+                        org_queued += 1
+                    else:
+                        try:
+                            geocode_order_task.apply_async(args=[order.pk])
+                            # Be slightly less verbose inside the loop
+                            # self.stdout.write(f"    Queued Order: {order.code} (PK: {order.pk})")
+                            org_queued += 1
+                        except Exception as e:
+                            self.stderr.write(self.style.ERROR(f"    ERROR queuing Order {order.code}: {e}"))
+                            logger.exception(f"Failed to queue geocoding task via command for order {order.code}: {e}")
+                            org_skipped += 1
+
+                self.stdout.write(f"  Queued: {org_queued}, Skipped: {org_skipped} for this organizer.")
+                total_queued += org_queued
+                total_skipped += org_skipped
+
+            # Scope for 'organizer' is automatically deactivated here by 'with' statement
+
+        # --- Final Report ---
+        self.stdout.write("=" * 40)
+        self.stdout.write("Overall Summary:")
+        self.stdout.write(f"  Organizers processed: {len(organizers_to_process)}")
+        self.stdout.write(f"  Total orders checked (paid): {total_processed_orders}")  # Report total checked
+        if dry_run:
+            self.stdout.write(
+                self.style.SUCCESS(f"[DRY RUN] Complete. Would have queued tasks for {total_queued} order(s)."))
+        else:
+            self.stdout.write(self.style.SUCCESS(f"Complete. Queued tasks for {total_queued} order(s)."))
+            if total_skipped > 0:
+                self.stdout.write(
+                    self.style.WARNING(f"Skipped {total_skipped} order(s) total due to errors during queueing."))
+        self.stdout.write("=" * 40)

pretix_mapplugin/models.py

@@ -0,0 +1,27 @@
+from django.db import models
+from pretix.base.models import LoggedModel, Order
+
+
+class OrderGeocodeData(LoggedModel):
+    """
+    Stores the geocoded coordinates for a Pretix Order's invoice address.
+    """
+    order = models.OneToOneField(
+        Order,
+        on_delete=models.CASCADE, # Delete geocode data if order is deleted
+        related_name='geocode_data', # Allows accessing this from order: order.geocode_data
+        primary_key=True # Use the order's PK as this model's PK for efficiency
+    )
+    latitude = models.FloatField()
+    longitude = models.FloatField()
+    geocoded_timestamp = models.DateTimeField(
+        auto_now_add=True # Automatically set when this record is created
+    )
+
+    class Meta:
+        # Optional: Define how instances are named in logs/admin
+        verbose_name = "Order Geocode Data"
+        verbose_name_plural = "Order Geocode Data"
+
+    def __str__(self):
+        return f"Geocode data for Order {self.order.code}"