pretix-map 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

pretix_mapplugin/views.py

@@ -1,163 +1,272 @@
-import logging
-from django.db.models import Prefetch  # Needed for prefetch_related optimization
-from django.http import HttpResponse, JsonResponse  # Import HttpResponse
-
-# --- CORRECTED IMPORTS ---
-from django.urls import reverse  # Needed to generate URLs
-from django.utils.formats import date_format  # For localized date formatting
-from django.utils.translation import gettext_lazy as _
-from django.views.generic import TemplateView, View
-from pretix.base.models import Order  # Make sure Order is imported
-from pretix.control.views.event import EventSettingsViewMixin
-
-from .models import OrderGeocodeData
-
-# --- END CORRECTED IMPORTS ---
-
-
-# --- Import CSP helpers (Still needed for SalesMapView) ---
-try:
-    from pretix.base.csp import _merge_csp, _parse_csp, _render_csp
-except ImportError:
-    from pretix.base.middleware import _merge_csp, _parse_csp, _render_csp
-
-logger = logging.getLogger(__name__)
-
-
-# --- SalesMapDataView (Modified to provide more data) ---
-class SalesMapDataView(EventSettingsViewMixin, View):
-    permission = 'can_view_orders'
-
-    def get(self, request, *args, **kwargs):
-        event = self.request.event
-        organizer = request.organizer  # Get organizer for URL generation
-
-        locations_data = []  # Initialize list to hold data for JSON
-
-        try:
-            # Fetch geocode entries, prefetch related order and its positions
-            geocode_entries = OrderGeocodeData.objects.filter(
-                order__event=event,
-                latitude__isnull=False,
-                longitude__isnull=False
-            ).select_related(
-                'order'  # Select the direct foreign key
-            ).prefetch_related(
-                Prefetch('order__positions')  # Use Prefetch for better control if needed, or just 'order__positions'
-            )
-
-            for entry in geocode_entries:
-                order = entry.order
-                order_url = None
-                tooltip_parts = []
-
-                # 1. Generate Order URL
-                try:
-                    # Use the standard name for the control panel order detail view
-                    # Ensure 'control:event.order' is the correct name in your Pretix version
-                    order_url = reverse('control:event.order', kwargs={
-                        'organizer': organizer.slug,
-                        'event': event.slug,
-                        'code': order.code,
-                    })
-                except Exception as e:
-                    logger.warning(f"Could not reverse URL for order {order.code}: {e}")
-
-                # 2. Build Tooltip String
-                tooltip_parts.append(f"<strong>Order:</strong> {order.code}")
-
-                # Format order date (using Django's localized formatting)
-                try:
-                    formatted_date = date_format(order.datetime, format='SHORT_DATETIME_FORMAT', use_l10n=True)
-                    tooltip_parts.append(f"<strong>Date:</strong> {formatted_date}")
-                except Exception as e:
-                    logger.warning(f"Could not format date for order {order.code}: {e}")
-                    tooltip_parts.append("<strong>Date:</strong> N/A")  # Fallback
-
-                # Count positions (tickets/items) - efficient due to prefetch_related
-                position_count = order.positions.count()  # count() is efficient on prefetched QuerySets
-                tooltip_parts.append(f"<strong>Items:</strong> {position_count}")
-
-                # Combine tooltip parts with HTML line breaks
-                tooltip_string = "<br>".join(tooltip_parts)
-
-                # 3. Append data to the list
-                locations_data.append({
-                    "lat": entry.latitude,
-                    "lon": entry.longitude,
-                    "tooltip": tooltip_string,  # The enhanced tooltip
-                    "order_url": order_url,  # The URL for clicking
-                })
-
-            logger.debug(f"Returning {len(locations_data)} enriched coordinates for event {event.slug}")
-            return JsonResponse({'locations': locations_data})
-
-        except OrderGeocodeData.DoesNotExist:
-            logger.info(f"No geocode data found for event {event.slug}")
-            return JsonResponse({'locations': []})
-        except Exception as e:
-            logger.exception(f"Error retrieving or processing geocode data for event {event.slug}: {e}")
-            # Provide a more generic error in production
-            return JsonResponse({'error': _('Could not retrieve coordinate data due to a server error.')}, status=500)
-
-
-class SalesMapView(EventSettingsViewMixin, TemplateView):
-    permission = 'can_view_orders'
-    template_name = 'pretix_mapplugin/map_page.html'
-
-    def get(self, request, *args, **kwargs):
-        try:
-            response = super().get(request, *args, **kwargs)
-        except Exception as e:
-            logger.exception(f"Error rendering template {self.template_name}: {e}")
-            return HttpResponse(_("Error loading map page."), status=500)
-
-        logger.debug(f"View: Attempting CSP modification for {request.path}")
-
-        # 2. Get existing CSP header
-        current_csp = {}
-        header_key = 'Content-Security-Policy'
-        if header_key in response:
-            header_value = response[header_key]
-            if isinstance(header_value, bytes):
-                header_value = header_value.decode('utf-8')
-            try:
-                current_csp = _parse_csp(header_value)
-                logger.debug(f"View: Found existing CSP header: {header_value}")
-            except Exception as e:
-                logger.error(f"View: Error parsing existing CSP header '{header_value}': {e}")
-                current_csp = {}
-        else:
-            logger.debug("View: No existing CSP header found.")
-            current_csp = {}
-
-        # 3. Define additions: img-src AND style-src
-        map_csp_additions = {
-            'img-src': [
-                'https://*.tile.openstreetmap.org',
-            ],
-            'style-src': [
-                "'unsafe-inline'",  # Allow inline styles needed by Leaflet/plugins
-            ]
-        }
-
-        # 4. Merge additions
-        try:
-            _merge_csp(current_csp, map_csp_additions)
-            logger.debug(f"View: CSP dict after merge: {current_csp}")
-        except Exception as e:
-            logger.error(f"View: Error merging CSP additions: {e}")
-
-        # 5. Render and set the header
-        if current_csp:
-            try:
-                new_header_value = _render_csp(current_csp)
-                response[header_key] = new_header_value
-                logger.info(f"View: Setting/modifying CSP header to: {new_header_value}")
-            except Exception as e:
-                logger.error(f"View: Error rendering final CSP header: {e}")
-        else:
-            logger.warning("View: CSP dictionary is empty after merge, header not set.")
-
-        # 6. Return the modified response object
-        return response
+import logging
+from collections import Counter
+from django.conf import settings
+from django.contrib import messages
+from django.db.models import Prefetch
+from django.forms import inlineformset_factory
+from django.http import HttpResponse, JsonResponse
+from django.shortcuts import redirect
+from django.urls import reverse
+from django.utils.formats import date_format
+from django.utils.translation import gettext_lazy as _
+from django.views.generic import TemplateView, View
+
+from pretix.base.models import Order, Event
+from pretix.control.views.event import EventSettingsViewMixin
+
+from .models import OrderGeocodeData, MapMilestone
+from .tasks import geocode_order_task
+from .geocoding import (
+    DEFAULT_NOMINATIM_USER_AGENT,
+    geocode_event_location,
+    get_best_address_string,
+    calculate_distance
+)
+
+# --- CSP Helpers ---
+try:
+    from pretix.base.csp import _merge_csp, _parse_csp, _render_csp
+except ImportError:
+    from pretix.base.middleware import _merge_csp, _parse_csp, _render_csp
+
+logger = logging.getLogger(__name__)
+
+
+# --- Milestone Management ---
+MilestoneFormSet = inlineformset_factory(
+    Event,
+    MapMilestone,
+    fields=('date', 'label'),
+    extra=1,
+    can_delete=True
+)
+
+
+class MilestoneSettingsView(EventSettingsViewMixin, TemplateView):
+    permission = 'can_change_event_settings'
+    template_name = 'pretix_mapplugin/milestones.html'
+
+    def get_context_data(self, **kwargs):
+        ctx = super().get_context_data(**kwargs)
+        if 'formset' not in ctx:
+            ctx['formset'] = MilestoneFormSet(
+                instance=self.request.event,
+                queryset=MapMilestone.objects.filter(event=self.request.event)
+            )
+        return ctx
+
+    def post(self, request, *args, **kwargs):
+        formset = MilestoneFormSet(
+            request.POST,
+            instance=self.request.event,
+            queryset=MapMilestone.objects.filter(event=self.request.event)
+        )
+        if formset.is_valid():
+            formset.save()
+            return redirect(reverse('plugins:pretix_mapplugin:event.settings.salesmap.milestones', kwargs={
+                'organizer': self.request.organizer.slug,
+                'event': self.request.event.slug,
+            }))
+        return self.render_to_response(self.get_context_data(formset=formset))
+
+
+class SingleGeocodeView(EventSettingsViewMixin, View):
+    permission = 'can_change_event_settings'
+
+    def post(self, request, *args, **kwargs):
+        order_pk = self.kwargs.get('order')
+        try:
+            order = Order.objects.get(pk=order_pk, event=self.request.event)
+        except Order.DoesNotExist:
+            return JsonResponse({'error': 'Order not found'}, status=404)
+
+        user_agent = DEFAULT_NOMINATIM_USER_AGENT
+        if hasattr(settings, 'CONFIG_FILE') and settings.CONFIG_FILE.has_section('pretix_mapplugin'):
+            user_agent = settings.CONFIG_FILE.get('pretix_mapplugin', 'nominatim_user_agent', fallback=DEFAULT_NOMINATIM_USER_AGENT)
+
+        geocode_order_task.apply_async(
+            args=[order.pk],
+            kwargs={
+                'nominatim_user_agent': user_agent,
+                'organizer_pk': self.request.organizer.pk
+            }
+        )
+        return JsonResponse({'success': True})
+
+
+class TriggerGeocodingView(EventSettingsViewMixin, View):
+    permission = 'can_change_event_settings'
+
+    def post(self, request, *args, **kwargs):
+        user_agent = DEFAULT_NOMINATIM_USER_AGENT
+        if hasattr(settings, 'CONFIG_FILE') and settings.CONFIG_FILE.has_section('pretix_mapplugin'):
+            user_agent = settings.CONFIG_FILE.get('pretix_mapplugin', 'nominatim_user_agent', fallback=DEFAULT_NOMINATIM_USER_AGENT)
+
+        orders_to_geocode = Order.objects.filter(
+            event=self.request.event,
+            status__in=[Order.STATUS_PAID, Order.STATUS_PENDING]
+        ).exclude(
+            geocode_data__latitude__isnull=False
+        )
+        
+        count = 0
+        for order in orders_to_geocode:
+            geocode_order_task.apply_async(
+                args=[order.pk],
+                kwargs={
+                    'nominatim_user_agent': user_agent,
+                    'organizer_pk': self.request.organizer.pk
+                }
+            )
+            count += 1
+        
+        messages.success(request, _("Queued {} orders for geocoding.").format(count))
+        return redirect(reverse('plugins:pretix_mapplugin:event.settings.salesmap.show', kwargs={
+            'organizer': self.request.organizer.slug,
+            'event': self.request.event.slug,
+        }))
+
+
+class SalesMapDataView(EventSettingsViewMixin, View):
+    permission = 'can_view_orders'
+
+    def get(self, request, *args, **kwargs):
+        event = self.request.event
+        organizer = request.organizer
+
+        user_agent = DEFAULT_NOMINATIM_USER_AGENT
+        if hasattr(settings, 'CONFIG_FILE') and settings.CONFIG_FILE.has_section('pretix_mapplugin'):
+            user_agent = settings.CONFIG_FILE.get('pretix_mapplugin', 'nominatim_user_agent', fallback=DEFAULT_NOMINATIM_USER_AGENT)
+            
+        milestones = [
+            {'date': m.date.isoformat(), 'label': m.label}
+            for m in MapMilestone.objects.filter(event=event)
+        ]
+
+        locations_data = []
+        failed_orders_data = []
+        city_counter = Counter()
+        item_counter = Counter()
+        distances = []
+        total_revenue = 0
+
+        try:
+            event_marker = None
+            event_coords = None
+            if event.location:
+                event_coords = geocode_event_location(event, user_agent)
+                if event_coords:
+                    event_marker = {'lat': event_coords[0], 'lon': event_coords[1], 'name': str(event.name), 'location': str(event.location)}
+
+            geocode_entries = OrderGeocodeData.objects.filter(
+                order__event=event, latitude__isnull=False, longitude__isnull=False
+            ).select_related('order', 'order__invoice_address').prefetch_related('order__positions__item')
+
+            for entry in geocode_entries:
+                order = entry.order
+                iso_date = order.datetime.isoformat() if order.datetime else ""
+                revenue = float(order.total)
+                
+                status = 'pending'
+                if order.status == Order.STATUS_PAID: status = 'paid'
+                elif order.status == Order.STATUS_CANCELED: status = 'canceled'
+
+                if status != 'canceled':
+                    total_revenue += revenue
+                    if order.invoice_address and order.invoice_address.city:
+                        city_counter[order.invoice_address.city] += 1
+                    dist_km = calculate_distance(event_coords, (entry.latitude, entry.longitude)) if event_coords else None
+                    if dist_km is not None: distances.append(dist_km)
+                else:
+                    dist_km = calculate_distance(event_coords, (entry.latitude, entry.longitude)) if event_coords else None
+
+                item_names = [str(p.item.name) for p in order.positions.all() if p.item]
+                if status != 'canceled':
+                    for name in item_names: item_counter[name] += 1
+
+                tooltip_parts = [f"<strong>Order:</strong> {order.code} ({status.upper()})"]
+                if order.datetime:
+                    tooltip_parts.append(f"<strong>Date:</strong> {date_format(order.datetime, format='SHORT_DATETIME_FORMAT', use_l10n=True)}")
+                tooltip_parts.append(f"<strong>Items:</strong> {order.positions.count()}")
+                tooltip_parts.append(f"<strong>Total:</strong> {order.total} {event.currency}")
+                if dist_km: tooltip_parts.append(f"<strong>Dist:</strong> {dist_km:.1f} km")
+
+                locations_data.append({
+                    "lat": entry.latitude, "lon": entry.longitude, "tooltip": "<br>".join(tooltip_parts),
+                    "order_url": reverse('control:event.order', kwargs={'organizer': organizer.slug, 'event': event.slug, 'code': order.code}),
+                    "items": item_names, "date": iso_date, "dist": dist_km, "revenue": revenue, "status": status
+                })
+
+            failed_entries = OrderGeocodeData.objects.filter(order__event=event, latitude__isnull=True).select_related('order', 'order__invoice_address')
+            for entry in failed_entries:
+                failed_orders_data.append({
+                    'pk': entry.order.pk, 'code': entry.order.code,
+                    'address': get_best_address_string(entry.order) or _("No address"),
+                    'url': reverse('control:event.order', kwargs={'organizer': organizer.slug, 'event': event.slug, 'code': entry.order.code}),
+                    'retry_url': reverse('plugins:pretix_mapplugin:event.settings.salesmap.retry', kwargs={'organizer': organizer.slug, 'event': event.slug, 'order': entry.order.pk})
+                })
+            
+            avg_dist_val = round(sum(distances) / len(distances), 1) if distances else 0
+
+            return JsonResponse({
+                'locations': locations_data, 'failed_orders': failed_orders_data,
+                'event_marker': event_marker, 'milestones': milestones,
+                'stats': {
+                    'top_cities': city_counter.most_common(10), 'top_items': item_counter.most_common(10),
+                    'total_orders': len(locations_data) + len(failed_orders_data),
+                    'geocoded_count': len(locations_data), 'avg_distance_km': avg_dist_val,
+                    'total_revenue': total_revenue, 'currency': event.currency
+                }
+            })
+        except Exception as e:
+            logger.exception(f"Error: {e}")
+            return JsonResponse({'error': _('Error')}, status=500)
+
+
+class SalesMapView(EventSettingsViewMixin, TemplateView):
+    permission = 'can_view_orders'
+    template_name = 'pretix_mapplugin/map_page.html'
+    
+    def get_context_data(self, **kwargs):
+        ctx = super().get_context_data(**kwargs)
+        ctx['other_events'] = self.request.organizer.events.exclude(pk=self.request.event.pk).order_by('-date_from')
+        return ctx
+
+    def get(self, request, *args, **kwargs):
+        try:
+            response = super().get(request, *args, **kwargs)
+        except Exception as e:
+            logger.exception(f"Error: {e}")
+            return HttpResponse(_("Error"), status=500)
+
+        current_csp = {}
+        header_key = 'Content-Security-Policy'
+        if header_key in response:
+            header_value = response[header_key]
+            if isinstance(header_value, bytes): header_value = header_value.decode('utf-8')
+            try:
+                from pretix.base.middleware import _parse_csp
+                current_csp = _parse_csp(header_value)
+            except Exception: current_csp = {}
+
+        # Allow external images for markers and Chart.js from CDN
+        map_csp_additions = {
+            'img-src': [
+                'https://*.tile.openstreetmap.org',
+                'https://raw.githubusercontent.com',
+                'https://cdnjs.cloudflare.com'
+            ],
+            'script-src': [
+                'https://cdn.jsdelivr.net',
+                "'unsafe-eval'" # Needed for some charting libs
+            ],
+            'style-src': ["'unsafe-inline'"]
+        }
+
+        try:
+            from pretix.base.middleware import _merge_csp, _render_csp
+            _merge_csp(current_csp, map_csp_additions)
+            response[header_key] = _render_csp(current_csp)
+        except Exception: pass
+
+        return response

pretix_map-0.1.3.dist-info/METADATA

@@ -1,195 +0,0 @@
-Metadata-Version: 2.4
-Name: pretix-map
-Version: 0.1.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