Add Configure Table button with per-user column preferences

Adds a Configure Table button to the Custom Objects tab card header.
Authenticated users can show, hide, and reorder the Type, Object,
Value, Field, and Tags columns via the standard NetBox modal; preferences
are persisted per-user in UserConfig under
tables.CustomObjectsTabTable.columns and applied on every page load,
including HTMX partial updates. The Actions column is exempt and always
visible.

Introduces CustomObjectsTabTable (a BaseTable subclass) in views.py
used solely for the column-preference machinery — no data is passed
through it. Column visibility is resolved from UserConfig on each
request and communicated to the templates via the selected_columns
context variable. Both templates guard each configurable <th>/<td>
pair with {% if 'col' in selected_columns %}.

Author: Kani999

CHANGELOG.md

@@ -53,6 +53,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   objects with a specific tag. Tag filtering composes with `?q=`, `?type=`, sort, and
   pagination. Tags are pre-fetched in bulk (`prefetch_related('tags')`) so there is no
   N+1 query cost.
+- **Configure Table** — a "Configure Table" button in the card header opens a NetBox
+  modal that lets authenticated users show, hide, and reorder columns (Type, Object,
+  Value, Field, Tags). Preferences are persisted per-user in `UserConfig` under
+  `tables.CustomObjectsTabTable.columns` and respected on every subsequent page load,
+  including HTMX partial updates. The Actions column is always visible and cannot be
+  hidden.
 
 ### Fixed
 

CLAUDE.md

@@ -181,6 +181,7 @@ Action buttons and column links use the `perms` templatetag from `utilities.temp
 - [x] 18. Add HTMX partial rendering (paginator, sort headers, search form, type dropdown)
 - [x] 19. Fix Edit/Delete return URL to redirect back to the Custom Objects tab
 - [x] 20. Add Tags column and tag filter dropdown to the Custom Objects tab
+- [x] 21. Add "Configure Table" button with per-user column show/hide/reorder preferences
 
 ## Critical Reference Files
 

README.md

@@ -126,6 +126,13 @@ Object instance:
 - **Multi-Object** fields: comma-separated links to the related objects, truncated
   at 3 with an ellipsis when more are present.
 
+### Configure Table
+A **Configure Table** button in the card header opens a NetBox modal that lets
+authenticated users show, hide, and reorder the table columns (Type, Object, Value,
+Field, Tags). Preferences are stored per-user in `UserConfig` and respected on every
+subsequent page load, including HTMX partial updates. The Actions column is always
+visible and cannot be hidden.
+
 ### Action buttons
 Each row has right-aligned action buttons, shown only when the user has the relevant permission:
 

netbox_custom_objects_tab/templates/netbox_custom_objects_tab/custom_objects_tab.html

@@ -1,5 +1,5 @@
 {% extends base_template %}
-{% load i18n custom_object_buttons perms %}
+{% load i18n custom_object_buttons perms helpers %}
 
 {% block content %}
 <div class="row">
@@ -70,6 +70,15 @@ <h2 class="mb-0">{% trans "Custom Objects" %}</h2>
             <input type="hidden" name="per_page" value="{{ request.GET.per_page }}">
           {% endif %}
         </form>
+        {% if request.user.is_authenticated %}
+          <button type="button"
+                  class="btn btn-sm btn-outline-secondary"
+                  data-bs-toggle="modal"
+                  data-bs-target="#CustomObjectsTabTable_config"
+                  title="{% trans 'Configure Table' %}">
+            <i class="mdi mdi-cog"></i> {% trans "Configure Table" %}
+          </button>
+        {% endif %}
       </div>
 
       {# --- table zone (swapped by HTMX) --- #}
@@ -78,4 +87,8 @@ <h2 class="mb-0">{% trans "Custom Objects" %}</h2>
     </div>
   </div>
 </div>
+{% block modals %}
+  {{ block.super }}
+  {% table_config_form tab_table %}
+{% endblock modals %}
 {% endblock content %}

netbox_custom_objects_tab/templates/netbox_custom_objects_tab/custom_objects_tab_partial.html

@@ -11,40 +11,51 @@
       <table class="table table-hover attr-table mb-0">
         <thead hx-target="#custom_objects_list" hx-swap="outerHTML" hx-push-url="true">
           <tr>
+            {% if 'type' in selected_columns %}
             <th>
               <a hx-get="{{ sort_headers.type.url }}">
                 {% trans "Type" %}
                 {% if sort_headers.type.icon %}<i class="mdi mdi-{{ sort_headers.type.icon }}"></i>{% endif %}
               </a>
             </th>
+            {% endif %}
+            {% if 'object' in selected_columns %}
             <th>
               <a hx-get="{{ sort_headers.object.url }}">
                 {% trans "Object" %}
                 {% if sort_headers.object.icon %}<i class="mdi mdi-{{ sort_headers.object.icon }}"></i>{% endif %}
               </a>
             </th>
-            <th>{% trans "Value" %}</th>
+            {% endif %}
+            {% if 'value' in selected_columns %}<th>{% trans "Value" %}</th>{% endif %}
+            {% if 'field' in selected_columns %}
             <th>
-              <a hx-get="{{ sort_headers.field.url }}">
+              <a hx-get="{{ sort_headers.field.url %}">
                 {% trans "Field" %}
                 {% if sort_headers.field.icon %}<i class="mdi mdi-{{ sort_headers.field.icon }}"></i>{% endif %}
               </a>
             </th>
-            <th>{% trans "Tags" %}</th>
+            {% endif %}
+            {% if 'tags' in selected_columns %}<th>{% trans "Tags" %}</th>{% endif %}
             <th></th>
           </tr>
         </thead>
         <tbody>
           {% for obj, field, value in page_rows %}
             <tr>
+              {% if 'type' in selected_columns %}
               <td>
                 {% if request.user|can_view:field.custom_object_type %}
                   <a href="{{ field.custom_object_type.get_absolute_url }}">{{ field.custom_object_type }}</a>
                 {% else %}
                   {{ field.custom_object_type }}
                 {% endif %}
               </td>
+              {% endif %}
+              {% if 'object' in selected_columns %}
               <td><a href="{{ obj.get_absolute_url }}">{{ obj }}</a></td>
+              {% endif %}
+              {% if 'value' in selected_columns %}
               <td>
                 {% if field.type == 'object' %}
                   {% if value %}
@@ -65,14 +76,19 @@
                   &mdash;
                 {% endif %}
               </td>
+              {% endif %}
+              {% if 'field' in selected_columns %}
               <td>{{ field }}</td>
+              {% endif %}
+              {% if 'tags' in selected_columns %}
               <td>
                 {% for t in obj.tags.all %}
                   {% tag t %}{% if not forloop.last %} {% endif %}
                 {% empty %}
                   &mdash;
                 {% endfor %}
               </td>
+              {% endif %}
               <td class="text-end text-nowrap">
                 {% if request.user|can_change:obj %}
                 <a href="{% url 'plugins:netbox_custom_objects:customobject_edit' pk=obj.pk custom_object_type=obj.custom_object_type.slug %}?return_url={{ return_url|urlencode }}" class="btn btn-yellow" role="button">

netbox_custom_objects_tab/views.py

@@ -2,20 +2,40 @@
 from types import SimpleNamespace
 from urllib.parse import urlencode
 
+import django_tables2 as tables2
 from django.apps import apps
 from django.contrib.contenttypes.models import ContentType
 from django.core.paginator import InvalidPage
 from django.shortcuts import get_object_or_404, render
+from django.utils.translation import gettext_lazy as _
 from django.views.generic import View
 
 from extras.choices import CustomFieldTypeChoices
 from netbox.plugins import get_plugin_config
+from netbox.tables import BaseTable
 from utilities.htmx import htmx_partial
 from utilities.paginator import EnhancedPaginator, get_paginate_count
 from utilities.views import ViewTab, register_model_view
 
 logger = logging.getLogger('netbox_custom_objects_tab')
 
+
+class CustomObjectsTabTable(BaseTable):
+    """Lightweight table class used only for column-preference machinery."""
+    type    = tables2.Column(verbose_name=_('Type'),   orderable=False)
+    object  = tables2.Column(verbose_name=_('Object'), orderable=False)
+    value   = tables2.Column(verbose_name=_('Value'),  orderable=False)
+    field   = tables2.Column(verbose_name=_('Field'),  orderable=False)
+    tags    = tables2.Column(verbose_name=_('Tags'),   orderable=False)
+    actions = tables2.Column(verbose_name='',          orderable=False)
+
+    exempt_columns = ('actions',)
+
+    class Meta(BaseTable.Meta):
+        fields = ('type', 'object', 'value', 'field', 'tags', 'actions')
+        default_columns = ('type', 'object', 'value', 'field', 'tags', 'actions')
+
+
 # Maximum number of related objects to show in the Value column for MULTIOBJECT fields.
 # One extra is fetched to detect truncation without a COUNT query.
 _MAX_MULTIOBJECT_DISPLAY = 3
@@ -184,6 +204,16 @@ def get(self, request, pk):
             instance = get_object_or_404(qs, pk=pk)
             linked_all = _get_linked_custom_objects(instance)
 
+            # Build table object for column-preference machinery (no data, just column config)
+            tab_table = CustomObjectsTabTable([], empty_text='')
+            visible_cols = None
+            if request.user.is_authenticated and (userconfig := getattr(request.user, 'config', None)):
+                visible_cols = userconfig.get(f'tables.{tab_table.name}.columns')
+            if visible_cols is None:
+                visible_cols = list(CustomObjectsTabTable.Meta.default_columns)
+            tab_table._set_columns(visible_cols)
+            selected_columns = {col for col, _ in tab_table.selected_columns} | set(tab_table.exempt_columns)
+
             # Collect unique types for the dropdown (always from the unfiltered list)
             seen_type_pks = set()
             available_types = []
@@ -280,6 +310,8 @@ def get(self, request, pk):
                 'sort_headers': sort_headers,
                 'htmx_table': SimpleNamespace(htmx_url=request.path, embedded=False),
                 'return_url': request.get_full_path(),
+                'tab_table': tab_table,
+                'selected_columns': selected_columns,
             }
 
             if htmx_partial(request):