Unable to Publish Custom Blog Module Pages in Antler Theme

[Furkan Cakmak]

Hello WHMCS Developer Community,

I’m building a custom blog module for WHMCS and integrating it into the Antler theme, but I can’t get the front-end pages to render. Here are the details:

1. Module Structure

   • Module folder: modules/addons/blog/

   • Main file: modules/addons/blog/blog.php (activated successfully)

   • Page files:

     • modules/addons/blog/pages/index.php (formerly grid.php)

     • modules/addons/blog/pages/details.php

2. Template Files

   • templates/antler/blog-grid.tpl

   • templates/antler/blog-details.tpl

3. Routing & URLs

   • Accessing list: https://<domain>/index.php?m=blog

   • Accessing details: https://<domain>/index.php?m=blog&page=details&id=<post_id>

4. Database & Data Retrieval

   • Using Capsule::table('mod_blog_posts')->get() and ->where('id', $id)->first()

   • Confirmed via print_r($posts) that data is fetched correctly.

5. Problem

   • No errors in logs.

   • Visiting either URL immediately redirects back to WHMCS homepage.

   • Smarty cache cleared, Developer Mode and error display enabled, but still no output.

6. What I’ve Tried

   • Renamed grid.php → index.php as per WHMCS page conventions.

   • Added ?page=grid and ?page=details URL parameters.

   • Cleared Smarty cache and verified template filenames.

   • Inserted print_r() before return to confirm data presence.

7. Request
   Could anyone advise on why WHMCS isn’t recognizing my addon pages or loading the Antler templates? Is there an additional hook or registration step I’m missing to expose m=blog as a client area route? Any sample code snippets or pointers would be greatly appreciated.

Thank you for your time and expertise!