Widgets Management

The Widgets management page allows you to view, organize, and manage widgets within your layout pages. Widgets are content blocks that can be positioned in different columns (Header, Column 1, Column 2, Column 3, Footer) and ordered by position. This page provides comprehensive tools for filtering, bulk operations, position management, and deletion workflows.

Quick Start

Filter widgets by page and column using the dropdown menus in the toolbar. Use the checkboxes to select multiple widgets for bulk operations. Edit widget positions using the position input fields and click "Update Positions" to save changes. Access the UnDelete view to restore or permanently remove deleted widgets.

Toolbar Functions

The toolbar provides essential navigation and filtering controls:

Button/Control Function
Back Returns to the previous page in browser history
UnDelete Switches to deleted widgets view for restoration or permanent deletion
Back to Widgets Returns from deleted view to active widgets (only visible in UnDelete mode)
Close Closes the page or returns to Control Panel
Refresh Reloads the current page to refresh data
Column Filter Dropdown to filter widgets by column: All Columns, Header, Column 1, Column 2, Column 3, Footer
Re-Sequence Automatically renumbers widget positions by increment value (default 1)
Update Positions Saves all position changes made in the position input fields

Data Table Columns

The widgets table displays comprehensive information about each widget:

Column Description
Checkbox Select individual widgets for bulk operations. Header checkbox selects/deselects all visible widgets
Page Layout page ID and name. Click the page ID to filter widgets to that specific page
Widget Widget type name in uppercase (e.g., HTML, MENU, CALENDAR)
Col Column number: 1-3 for main columns, 4 for Header, 5 for Footer
Pos Position within column. Editable input field for reordering widgets
Xtra Info Widget name or additional information (first 80 characters)
User Username of the widget owner in uppercase
Actions Action buttons for individual widget operations (Edit, Delete, Attributes)
Status PLHA status indicator showing widget permissions and visibility
ID Unique widget identifier number

Action Buttons

Each widget row contains action buttons for individual operations:

Active Widgets Actions

  • Del - Soft delete the widget (moves to deleted status, can be restored)
  • Edit - Open widget editor in modal dialog
  • Attr - Edit widget attributes (Admin only)

Deleted Widgets Actions

  • Undel - Restore the widget to active status
  • HardDel - Permanently delete the widget (cannot be undone)

Filtering and Navigation

Column Filtering

Use the column dropdown in the toolbar to filter widgets by their column position:

  1. All Columns - Shows widgets from all column positions
  2. Header - Shows only header widgets (Column 4)
  3. Column 1 - Shows only left column widgets
  4. Column 2 - Shows only center column widgets
  5. Column 3 - Shows only right column widgets
  6. Footer - Shows only footer widgets (Column 5)

Page Filtering

Click on any page ID in the Page column to filter widgets to that specific layout page. The current page filter is displayed in the record count badge on the right side of the toolbar.

Search Functionality

Use the search box in the DataTables controls to filter widgets by any visible text content including page names, widget types, extra info, and usernames.

Position Management

Manual Position Updates

  1. Edit the position values in the Pos column input fields
  2. Make changes to multiple widgets as needed
  3. Click the Update Positions button to save all changes
  4. Widgets will be reordered according to their new position values

Automatic Re-sequencing

  1. Set the increment value (default is 1) in the Inc field
  2. Click the Re-Sequence button
  3. All widgets will be automatically renumbered in increments
  4. First widget gets position 1, second gets 2, etc. (or by increment value)
  5. Click Update Positions to save the new sequence

Position Tips

Position numbers determine display order within each column. Lower numbers appear first. You can use decimal values (e.g., 1.5) to insert widgets between existing positions without renumbering everything.

Bulk Operations

Bulk Delete Workflow

  1. Select widgets using individual checkboxes or the header "Select All" checkbox
  2. Click the Delete Selected button that appears in the DataTables toolbar
  3. Confirm the deletion in the popup dialog
  4. Selected widgets will be soft deleted (marked as deleted but not removed)
  5. Use the UnDelete button to view and manage deleted widgets

Bulk Undelete Workflow

  1. Click the UnDelete button to view deleted widgets
  2. Select widgets to restore using checkboxes
  3. Click the UnDelete Selected button
  4. Confirm the restoration in the popup dialog
  5. Selected widgets will be restored to active status

Bulk Hard Delete Workflow

  1. Navigate to the deleted widgets view using the UnDelete button
  2. Select widgets to permanently delete using checkboxes
  3. Click the Permanently Delete button
  4. Confirm the permanent deletion in the warning dialog
  5. Warning: This action cannot be undone - widgets are permanently removed

Permission System

User Access Control

Widget visibility is controlled by user permissions:

  • Admin1 users can see all widgets regardless of owner
  • Regular users can only see widgets they own or widgets owned by members of their workgroup
  • Workgroup members share access to each other's widgets
  • The current user is displayed in the header bar badge

Widget Attributes Access

The Attr (Attributes) button is only visible to Admin users (Client.ID = 1). This opens a popup window for advanced widget configuration including permissions, colors, and display settings.

Status Indicators

PLHA Status System

The Status column displays PLHA (Permissions, Layout, Header, Access) indicators:

  • P - Public access
  • L - Limited access
  • H - Hidden from users
  • A - Admin only

Record Count Display

The toolbar shows current filtering status:

  • Total number of widgets matching current filters
  • Current page filter (if applicable)
  • Current column filter (if not "All Columns")
  • "Showing Deleted" indicator when in UnDelete mode

DataTable Features

Pagination and Display

  • Default page size: 25 widgets per page
  • Page size options: 25, 50, 100, or All records
  • State saving: Your pagination, sorting, and search settings are remembered
  • Responsive design: Table adapts to different screen sizes

Sorting Capabilities

  • Click column headers to sort data
  • Position column sorts numerically (handles decimal values)
  • Default sort preserves database order (Column, then Position)
  • Multi-column sorting available with Shift+click

Search and Filtering

  • Global search box filters across all visible columns
  • Search works with partial matches
  • Checkbox selection works across filtered results
  • Search state is preserved when navigating

Common Workflows

Reordering Widgets in a Column

  1. Filter to the specific page and column you want to work with
  2. Review current widget positions in the Pos column
  3. Edit position values to achieve desired order
  4. Click Update Positions to save changes
  5. Refresh the page to see the new order reflected

Cleaning Up Deleted Widgets

  1. Click the UnDelete button to view deleted widgets
  2. Review deleted widgets to identify what should be restored vs. permanently removed
  3. Select widgets to restore and click UnDelete Selected
  4. Select widgets to permanently remove and click Permanently Delete
  5. Return to active widgets view with Back to Widgets

Bulk Widget Organization

  1. Filter to the page and column you want to organize
  2. Use Re-Sequence with increment 10 to create gaps between positions
  3. Click Update Positions to apply the new sequence
  4. Now you can easily insert widgets at positions 5, 15, 25, etc.
  5. Fine-tune individual positions as needed

Summary

The Widgets management page provides comprehensive tools for organizing and maintaining your layout widgets. Use the filtering options to focus on specific pages and columns, leverage bulk operations for efficiency, and utilize the position management tools to maintain proper widget ordering. Remember that soft deletion allows for recovery, while hard deletion is permanent. The PLHA status system helps you understand widget visibility and permissions at a glance.