<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>hooks on</title><link>https://docs.whmcs.com/9-1/tags/hooks/</link><description>Recent content in hooks on</description><generator>Hugo -- gohugo.io</generator><atom:link href="https://docs.whmcs.com/9-1/tags/hooks/index.xml" rel="self" type="application/rss+xml"/><item><title>Billing Logic</title><link>https://docs.whmcs.com/9-1/billing-and-invoicing/billing-logic/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/billing-and-invoicing/billing-logic/</guid><description>Details the ordering, invoicing, payment, and provisioning workflow, the Next Due Date and Continuous Invoice Generation logic, billing cycle calculations, overpayment and refund handling, payment and affiliate commission reversals, and the automated suspension, unsuspension, and termination triggers with their action hook points.</description></item><item><title>Troubleshooting Customizations</title><link>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-customizations/troubleshooting-customizations/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-customizations/troubleshooting-customizations/</guid><description>Links to dedicated troubleshooting pages for hooks, order form templates, system themes, and WHMCS API calls, and lists common issue links for order-form-template and system-theme problems via the troubleshooting-links shortcode.</description></item><item><title>Troubleshooting Hooks</title><link>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-customizations/troubleshooting-hooks/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-customizations/troubleshooting-hooks/</guid><description>Explains how to enable Hooks Debug Mode in General Settings &amp;gt; Other and check System Logs for Hook File Loaded and Called Hook Point entries, use logActivity() to inspect hook variables, and re-save module settings after adding or modifying hook files on an already-active module.</description></item><item><title>Add a Menu Item</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/add-a-menu-item/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/add-a-menu-item/</guid><description>Provides PHP hook examples using the ClientAreaPrimaryNavbar hook with addChild, setUri, and setOrder to add a top-level menu item, a child item under an existing menu, a localized label via Lang::trans, and a conditionally displayed item based on client login status via Menu::context.</description></item><item><title>Add a Panel to Specific Pages</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-panel-to-specific-pages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-panel-to-specific-pages/</guid><description>Provides a PHP hook example using the ClientAreaPrimarySidebar hook and Menu Item addChild, moveToFront, and setBodyHtml methods to add a conditional Support Hours panel that only appears on the submitticket.php page and greets the logged-in client by name.</description></item><item><title>Add a Promotional Offer Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-promotional-offer-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-promotional-offer-panel/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook and addChild method to create a promotional homepage panel with a colored badge, custom body and footer HTML, and a button link, ordered to appear after default invoice panels.</description></item><item><title>Add a Sidebar Item</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/add-a-sidebar-item/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/add-a-sidebar-item/</guid><description>Provides a PHP hook example using the ClientAreaPrimarySidebar hook with addChild, setLabel, setUri, setIcon, and setOrder methods to add a Subscription Preferences link under the My Account sidebar item.</description></item><item><title>Add a Social Media Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-social-media-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-social-media-panel/</guid><description>Provides a PHP hook example using the ClientAreaSecondarySidebar hook with addChild, getChild, and moveToBack methods to build a social media panel containing Facebook and Twitter links positioned at the end of the sidebar, and mentions the General Settings Social Accounts alternative.</description></item><item><title>Add a Special Offer Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-special-offer-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-a-special-offer-panel/</guid><description>Provides a PHP hook example using the ClientAreaPrimarySidebar hook with getFirstChild and setBodyHtml methods to inject a special-offer image and link into the topmost sidebar panel across every Client Area page.</description></item><item><title>Add an Informational Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-an-informational-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/add-an-informational-panel/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook, the WHMCS\User\Client class, SOAP calls to the US National Weather Service, and the Carbon library to build a Local Temperatures panel showing today&amp;rsquo;s and a five-day forecast, moved to the front of the panel list.</description></item><item><title>Change a Menu Item Label</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/change-a-menu-item-label/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/change-a-menu-item-label/</guid><description>Explains that default menu item labels come from language files and provides a PHP hook example using the ClientAreaPrimaryNavbar hook, getChild, and setLabel methods to rename the Announcements child item under the Support menu.</description></item><item><title>Change a Menu Item Link</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/change-menu-item-link/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/change-menu-item-link/</guid><description>Provides a PHP hook example using the ClientAreaPrimaryNavbar hook, getChild, and setUri methods to repoint the Announcements menu item under Support to an external blog system URL.</description></item><item><title>Change a Sidebar Menu Label</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/change-a-sidebar-menu-label/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/change-a-sidebar-menu-label/</guid><description>Explains that default sidebar labels come from language files and provides a PHP hook example using the ClientAreaPrimarySidebar hook, getChild, and setLabel methods to rename the Billing Information item under My Account.</description></item><item><title>Change a Sidebar Menu Link</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/change-a-sidebar-menu-link/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/change-a-sidebar-menu-link/</guid><description>Provides a PHP code example using the ClientAreaPrimarySidebar hook and the setUri method to change a sidebar menu item&amp;rsquo;s link target, such as pointing Billing Information to an external URL.</description></item><item><title>Client Area Homepage Panels</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-homepage-panels/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-homepage-panels/</guid><description>Describes the homepage panel tree structure, custom color options, optional button extras (btn-link, btn-text, btn-icon, colspan), the table of default panels with order and required permissions, the ClientAreaHomepagePanels hook, and the CustomActions server module function.</description></item><item><title>Client Area Navigation Menus</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-navigation-menus/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-navigation-menus/</guid><description>Covers the primary and secondary navigation bar structure, the Item class&amp;rsquo;s menu item properties (label, URI, icon, badge, order), finding a menu item&amp;rsquo;s name via Inspect Element, and the ClientAreaPrimaryNavbar and ClientAreaSecondaryNavbar hooks.</description></item><item><title>Client Area Sidebars</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-sidebars/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization/client-area-sidebars/</guid><description>Explains the sidebar tree structure of panels and panel items, Desktop and Responsive layout behavior, the Item class properties (parent, children, label, icon, badge, order), how to find a sidebar item&amp;rsquo;s name via Inspect Element, the ClientAreaPrimarySidebar, ClientAreaSecondarySidebar, and ClientAreaSidebars hooks, direct Menu class access via primarySidebar() and secondarySidebar(), and using CustomActions to add server module items to the service details sidebar.</description></item><item><title>Create a Two-Column Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/create-a-two-column-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/create-a-two-column-panel/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook and setExtra colspan option to convert the Register a New Domain homepage panel into a two-column layout while in Desktop Mode.</description></item><item><title>Create Admin Dashboard Widgets</title><link>https://docs.whmcs.com/9-1/customization/create-admin-dashboard-widgets/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/create-admin-dashboard-widgets/</guid><description>Describes creating custom Admin Dashboard widgets by defining a function that returns a title and content array, registering it through the AdminHomeWidgets hook, and locating the open-source default widget code in the /modules/widgets folder for reference or customization.</description></item><item><title>Custom Template PHP</title><link>https://docs.whmcs.com/9-1/system/php/custom-template-php/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/system/php/custom-template-php/</guid><description>Provides an example hook_template_variables_example() function using add_hook() on the ClientAreaPageViewTicket hook point to define custom Smarty template variables like {$fixedValue} and {$userSpecificValue} for use in a .tpl file.</description></item><item><title>Customizing Promotions</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization/customizing-promotions/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization/customizing-promotions/</guid><description>Covers customizing MarketConnect order form templates located in the store directory of the system theme, modifying or replacing promotion wording and merchandising content using hooks, and notes that MarketConnect promotions render through the same standard Client Area hook and rendering workflow as other pages.</description></item><item><title>Modify an Existing Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/modify-an-existing-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/modify-an-existing-panel/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook, getChild, and setExtras methods to change the color, button text, button link, and icon of the existing Recent Support Tickets homepage panel.</description></item><item><title>Open Menu Links in New Tabs</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/open-menu-links-in-new-tabs/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/open-menu-links-in-new-tabs/</guid><description>Provides a PHP hook example using the ClientAreaPrimaryNavbar hook, setUri, and setAttribute methods to point the Knowledgebase menu item to an external URL and force it to open in a new browser tab via target=_blank.</description></item><item><title>Other</title><link>https://docs.whmcs.com/9-1/system/general-settings/general-settings-other/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/system/general-settings/general-settings-other/</guid><description>Documents Marketing Emails opt-in settings, Admin Client Display Format, Default to Client Area, Client Area User Management, Client Registration, Optional/Locked Profile Fields, Show Cancellation Link, Banned Subdomain Prefixes, Encoded File Loading, Event Handling (Concurrent/Inline/Cron), Display Errors, Log Errors, SQL Debug Mode, and Hooks Debug Mode.</description></item><item><title>Rearrange Menu Items</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/rearrange-menu-items/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/rearrange-menu-items/</guid><description>Provides a PHP hook example using the ClientAreaPrimaryNavbar hook and setOrder method to reposition the Announcements menu item, and lists the moveUp, moveDown, moveToFront, and moveToBack helper methods with usage examples.</description></item><item><title>Rearrange Panels</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/rearrange-panels/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/rearrange-panels/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook, getChild, and setOrder methods to move the Register a New Domain homepage panel to the first position in the panel list.</description></item><item><title>Rearrange Sidebar Items</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/rearrange-sidebar-items/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/rearrange-sidebar-items/</guid><description>Shows a ClientAreaPrimarySidebar hook example using setOrder to reorder sidebar menu items, plus a helper table for moveUp, moveDown, moveToFront, and moveToBack methods on a menu item.</description></item><item><title>Remove a Menu Item</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/remove-a-menu-item/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/navigation/remove-a-menu-item/</guid><description>Provides PHP hook examples using the ClientAreaPrimaryNavbar hook and removeChild method to delete the top-level Network Status menu item and the Announcements child item under Support.</description></item><item><title>Remove a Panel</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/remove-a-panel/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/homepage-panels/remove-a-panel/</guid><description>Provides a PHP hook example using the ClientAreaHomepagePanels hook, getChild, and removeChild methods to delete the Register a New Domain panel from the Client Area homepage.</description></item><item><title>Remove a Sidebar Item</title><link>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/remove-a-sidebar-item/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/sidebars/remove-a-sidebar-item/</guid><description>Gives two PHP hook examples for removing sidebar items: a ClientAreaPrimarySidebar hook using removeChild to delete a menu item unconditionally, and a ClientAreaSidebars hook that checks the primary or secondary sidebar before removing a named item like Client Contacts.</description></item><item><title>Sending Aborted by Hook</title><link>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-email/sending-aborted-by-hook/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-email/sending-aborted-by-hook/</guid><description>Details how to trace an &amp;ldquo;Email Send Aborted By Hook&amp;rdquo; error to the responsible custom hook file by enabling Hooks Debug Mode in General Settings &amp;gt; Other, reproducing the error, and reviewing the Activity Log for the Hook File Loaded and Attempting to load hook file entries.</description></item><item><title>Transliteration</title><link>https://docs.whmcs.com/9-1/customization/transliteration/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.whmcs.com/9-1/customization/transliteration/</guid><description>Explains overriding WHMCS&amp;rsquo;s default character-replacement behavior by defining a hook_transliterate function in /includes/hooks/, with a PHP example converting accented characters like ž and é to plain ASCII equivalents for use in client profile data sent to third-party systems such as domain registrars.</description></item></channel></rss>