Pagelinks Management

The Pagelinks Management interface provides comprehensive tools for managing linksets (collections of related links) across your website. This system allows you to organize, edit, and maintain groups of links that can be displayed on various pages through widgets or direct inclusion.

Quick Start

To get started: Click "Add Linkset" to create a new collection of links, or use the search box to find existing linksets. Click "Edit" next to any linkset to modify its links, or "View" to see the links inline below the table.

Toolbar Functions

The toolbar provides quick access to all primary functions for managing linksets:

Button Function Description
Add Linkset Create New Linkset Opens the linkset creation form to define a new collection of links
Add Link Create Individual Link Opens the link editor to add a single link to any linkset (requires Links_Add permission)
Back Browser Back Returns to the previous page in your browser history
Close Close Window Closes the current window or returns to Control Panel if in a frame
ð??? Refresh Page Reloads the current page to show the latest data
Linksets... Quick Navigation Dropdown menu to quickly jump to any specific linkset by name
ð??쳌 Search Function Filter linksets by name using the search input box
Show All Clear Search Removes all search filters and displays all available linksets
Empty Hidden Toggle Empty Linksets Shows/hides linksets that contain zero links (state persists between sessions)
UnDelete Deleted Items View Switches to show only linksets containing soft-deleted links for recovery

Linksets Table

The main table displays all linksets with comprehensive management options. The table supports sorting, pagination, and real-time search functionality.

Table Columns

Column Description Details
â?? Selection Checkbox Select multiple linksets for bulk operations (delete/undelete)
Linkset Linkset Name The unique identifier/name for this collection of links (sortable)
Links Link Count Green = has links, Red = empty linkset
Edit Edit Action Opens the full linkset editor (requires Links_Edit permission)
View View Action Displays the linkset contents inline below the table
Add Add Link Opens the link editor to add a new link to this specific linkset
Widget Widget Control Opens widget configuration to embed this linkset on pages
Delete Delete Linkset Soft-deletes ALL links in the linkset (can be recovered)
â?? Quick Access Arrow button for quick access to linkset editing
ID Minimum Link ID Shows the lowest ID number of links in this linkset (for reference)

Bulk Operations

The system supports bulk operations on multiple linksets simultaneously using the checkboxes in the first column.

Bulk Delete Workflow

  1. Select Linksets: Check the boxes next to linksets you want to delete
  2. Click Delete Selected: The button appears in the table controls area
  3. Confirm Action: A confirmation dialog will ask you to verify the bulk delete
  4. Soft Delete Applied: All links in selected linksets are marked as deleted (Active=2)
  5. Recovery Available: Deleted linksets can be recovered using the UnDelete function

Bulk Recovery Workflow

  1. Access Deleted View: Click the "UnDelete" button in the toolbar
  2. Select Linksets: Check boxes next to linksets you want to recover
  3. Click Un-Delete Selected: Restores all links in selected linksets
  4. Permanent Delete Option: "Permanently Delete" button removes links forever

Bulk Operations Tip

The "Check All" checkbox in the table header will select all visible linksets on the current page. For bulk operations across multiple pages, you'll need to navigate to each page and select items individually.

Search and Filtering

Multiple search and filtering options help you locate specific linksets quickly:

Search Methods

Method Function Usage
Search Box Text Search Type partial linkset names to filter results (case-insensitive)
Linksets Dropdown Direct Navigation Select a specific linkset name to jump directly to it
DataTables Search Live Filtering Built-in table search filters all visible columns in real-time
Empty Toggle Content Filtering Show/hide linksets with zero links (preference saved)
Deleted View Status Filtering Switch between active and deleted linksets view

Permissions System

The linksets management system uses a role-based permission structure to control access to different functions:

Permission Required For Description
Links Basic Access Required to access the linksets management page
Links_Review Review Access Allows viewing and reviewing linksets (read-only access)
Links_Edit Edit Functions Enables the Edit button and linkset modification capabilities
Links_Add Creation Functions Shows Add Link and Add buttons for creating new content
Admin (ID=1) Full Access Bypasses all permission checks and sees all linksets

Workgroup Filtering

Unless you are Admin (ID=1), you will only see linksets that belong to:

  • Your own user account (Owner = your username)
  • Members of your assigned workgroups
  • This filtering applies to both active and deleted linksets

Delete and Recovery System

The system uses a three-tier deletion approach to protect against accidental data loss:

Deletion States

State Active Value Description
Active 1 Link is active and visible in normal operations
Inactive 0 Link is temporarily disabled but not deleted
Soft-Deleted 2 Link is deleted but can be recovered via UnDelete
Hard-Deleted - Link is permanently removed from the database

Recovery Workflow

  1. Access Deleted Items: Click "UnDelete" button in main toolbar
  2. View Deleted Linksets: Only linksets containing soft-deleted links appear
  3. Select for Recovery: Check boxes next to linksets to restore
  4. Un-Delete Selected: Restores all links in selected linksets to Active status
  5. Return to Normal View: Click "Back to Linksets" to return to main view

Permanent Deletion Warning

The "Permanently Delete" button in the deleted items view will remove links forever. This action cannot be undone and should be used with extreme caution.

Inline Viewing

When you click the "View" button next to any linkset, the system displays the linkset contents inline below the main table.

Inline View Features

  • Immediate Display: Links appear in a card below the main table
  • Add Link Button: Quick access to add new links to the viewed linkset
  • Link Testing: Built-in link validation shows which links are working
  • Persistent View: The inline view remains visible while you work with other linksets
  • URL Parameters: The view state is maintained in the URL for bookmarking

The inline view uses the cf_linktest component which provides:

  • Visual indicators for link status (working/broken)
  • Response time information
  • HTTP status code reporting
  • Automatic link validation

Table Controls and Features

The linksets table uses DataTables for enhanced functionality and user experience:

Pagination Controls

Control Function Options
Show Entries Items Per Page 25, 50, 100, or All linksets per page
Page Numbers Page Navigation Click numbers or use Previous/Next buttons
Info Display Status Information "Showing X to Y of Z linksets" with filter status

Sorting Functionality

  • Sortable Columns: Linkset name and Links count can be sorted
  • Default Sort: Linkset names in ascending alphabetical order
  • Visual Indicators: Arrow icons show current sort direction
  • Multi-Column Sort: Hold Shift while clicking for secondary sort

State Persistence

The table remembers your preferences between sessions:

  • Search terms and filters
  • Current page position
  • Items per page setting
  • Sort column and direction
  • Empty linksets visibility toggle

Widget Integration

Each linkset can be embedded on website pages using the widget system:

Widget Creation Workflow

  1. Click Widget Button: Click the "Widget" button next to any linkset
  2. Widget Control Opens: A popup window displays widget configuration options
  3. Configure Display: Set styling, layout, and display preferences
  4. Generate Code: System creates embed code for the linkset
  5. Deploy Widget: Add the widget to pages where the linkset should appear

Widget Features

  • Responsive Design: Widgets adapt to different screen sizes
  • Custom Styling: Match your website's design and branding
  • Dynamic Updates: Changes to linksets automatically appear in widgets
  • Performance Optimized: Efficient loading and caching

Troubleshooting

Common Issues and Solutions

Issue Possible Cause Solution
Can't see Edit button Missing Links_Edit permission Contact administrator to add Links_Edit to your permissions
Can't see Add buttons Missing Links_Add permission Request Links_Add permission from your administrator
Limited linksets visible Workgroup filtering active You only see linksets owned by you or your workgroup members
Search not working Cached search state Click "Show All" to clear all filters and start fresh
Table not loading JavaScript/CDN issue Refresh the page or check internet connection
Bulk operations not working No items selected Check at least one linkset before using bulk operations

Performance Tips

  • Use Search: Filter large lists instead of showing all linksets
  • Hide Empty Linksets: Toggle off empty linksets to reduce table size
  • Paginate Results: Use smaller page sizes (25-50) for better performance
  • Clear Filters: Use "Show All" to reset and clear cached search states

Summary

The Pagelinks Management system provides comprehensive tools for organizing and maintaining linksets across your website. With features like bulk operations, soft-delete protection, real-time search, widget integration, and role-based permissions, you can efficiently manage collections of links while maintaining data integrity. The intuitive interface supports both quick edits and detailed management workflows, making it suitable for both casual users and power administrators.