Blog Posts

GIBS.Module.DeepLink
An Oqtane framework module for managing and displaying SEO-friendly deep links with categories, multiple display layouts, and built-in click tracking. It supports centralized link management with flexible presentation options for different page designs and use cases. Built-in analytics and modular configuration make it easy to optimize link visibility and performance across your site.
Features
Core modules
- DeepLink module for full link and category management.
- DeepLink Links module for displaying links from this or another DeepLink module instance.
Link management
- Create, edit, and delete deep links.
- Assign links to categories.
- Active/inactive link status.
- Optional description per link.
- Automatic slug generation from link name.
- Click count tracking per link.
- Audit fields support (created/modified metadata).
Category management
- Create, edit, and delete categories.
- Parent/child category hierarchy.
- Sort order and move up/down controls.
- Active/inactive category status.
- Automatic slug generation from category name.
Display layouts
Each module instance can render links using:
- Card (default)
- PipeSeparator
- Accordion
- BulletedList
- Chips
Display options
- Custom title per instance.
- Filter by category.
- Randomize link order.
- Limit max number of displayed records.
- Accordion grouping by category name.
Cross-module display
- DeepLink Links module can target another DeepLink module by module ID.
- Reuse centralized link data across multiple pages/locations.
Click tracking
- Client-side tracking script for module links.
- Server endpoints increment click counts.
- Supports redirect tracking and beacon-style click tracking.
Security and permissions
- View secured by Oqtane module view permission.
- Add/update/delete secured by Oqtane module edit permission.
- Multi-tenant aware service/repository implementation.
Search, import/export, and install
- Implements Oqtane install/uninstall migrations.
- Implements portable import/export support.
- Implements searchable content integration.
API Endpoints
DeepLink
GET api/DeepLink?moduleid={id}GET api/DeepLink/{id}/{moduleid}POST api/DeepLinkPUT api/DeepLink/{id}DELETE api/DeepLink/{id}/{moduleid}GET api/DeepLink/track/{id}/{moduleid}GET api/DeepLink/click?id={id}&moduleid={moduleid}POST api/DeepLink/click/{id}/{moduleid}
Category
GET api/Category?moduleid={id}GET api/Category/{id}/{moduleid}POST api/CategoryPUT api/Category/{id}DELETE api/Category/{id}/{moduleid}
Solution structure
Client/- Blazor UI, module controls, and client services.Server/- API controllers, services, repositories, migrations, static assets.Shared/- shared interfaces and models.Package/- packaging artifacts and scripts.
Tech details
- Target framework: .NET 10
- Language version: C# 14.0
- Built for the Oqtane modular architecture.
Notes
- The module uses Bootstrap-based markup for responsive rendering.
Server/wwwroot/Module.cssis available for additional custom styling.