Summary

This document begins tracking all updates and discussions initiated under the marker “2509.16 Pages Update.” It includes recorded details about the WordPress environment, plugins in use, and other relevant information for debugging, code improvements, and other development tasks related to Store Locator Plus®.

Issue context: In the Power add-on, the “Enable Pages” option (Options → HTML panel → App) has field ID options_nojs[use_pages]. This value is stored in the WordPress wp_options table under option name csl-slplus-options_nojs as a serialized key/value pair, using the key use_pages. When use_pages is true (stored value 1), the system should render a Store Pages submenu under the main Store Locator Plus menu. This is currently not happening and is the focus of this update.

Findings: use_pages and Pages submenu attachment

Where use_pages is referenced

• Smart option definition: store-locator-plus/include/module/smartoptions/SLP_SmartOptions.php (property $use_pages).
• Power bootstrap: slp-power/include/SLPPower.php
  • init_using_pages() sets $this->using_pages from SmartOptions->is_true('use_pages') (lines ~642, 650–651).
• AJAX module conditional behavior: slp-power/include/module/ajax/SLP_Power_AJAX.php checks SmartOptions->is_false('use_pages') (around line ~711).
• Admin info and options: slp-power/include/module/admin/* and slp-power/include/module/options/SLP_Power_Options.php define/use defaults for use_pages.
• MySLP dashboard references: myspl-dashboard assets read/write a checkbox with id #use_pages.

Where the Pages submenu is added

• slp-power/include/module/pages/SLP_Power_Pages_Global.php
  • Hooks add_filter('slp_menu_items', ...) in add_hooks_and_filters().
  • add_pages_tab() appends a menu item only when $power->using_pages is true.
  • The menu entry is defined as: label Pages, slug slp-pages, class $power->admin->pages, function render_pages_tab.
• slp-power/include/module/pages/SLP_Power_Pages_Admin.php
  • Provides render_pages_tab() which renders the Pages admin UI.
• Core menu attachment: store-locator-plus/include/module/admin/SLP_Admin_UI.php
  • create_admin_menu() collects menu entries via the slp_menu_items filter and, on classic WP installs, calls add_submenu_page() with the parent slug SLPLUS_PREFIX.
• Parent menu slug definition: store-locator-plus/include/base/loader.php defines SLPLUS_PREFIX as csl-slplus.

Potential reasons the Pages submenu may not render

• use_pages evaluates false: $power->using_pages is false, so add_pages_tab() returns without appending the menu item.
• Filter not initialized: The SLP_Power_Pages_Global class may not be instantiated when using pages; ensure its initialize() runs after slp_init.
• Parent menu slug mismatch: If the main menu parent slug changed from csl-slplus, items added via slp_menu_items would attempt to attach to the wrong parent. Current core uses SLPLUS_PREFIX which equals csl-slplus.
• Admin pages controller not present: If $power->admin->pages is not constructed, the callable may be invalid and WordPress could skip the submenu.

Conclusion: The Pages submenu is added by the Power add-on via the slp_menu_items filter (in SLP_Power_Pages_Global::add_pages_tab) and attached by core SLP in SLP_Admin_UI::create_admin_menu under the parent slug csl-slplus. Verify use_pages is true and that the parent slug has not changed.

Environment

• Site URL: http://localhost
• Store Locator Plus®: 2508.20.01
• Power: 2506.30.01
• SLP Network Active: No
• WordPress Version: 6.8.2
• WordPress Memory Limit: 40M
• WordPress Max Memory Limit: 256M
• PHP Version: 8.3.1
• PHP Memory Limit: 128M
• PHP Post Max Size: 64M
• PHP Peak RAM: 6 MB
• MySQL Version: 8.3.0

Installed Plugins

• Primary Plugin: Store Locator Plus® (store-locator-plus)
• Power Add-on: SLP Power (slp-power)
• Experience Add-on: SLP Experience (slp-experience)
• Premier Add-on: SLP Premier (slp-premier)