Praxis Guides - Step-by-Step How-To Articles for XenForo V1.0.5

Improved Guide Image Quality​

Praxis Guides now displays step images using their original attachment source instead of generated preview thumbnails.

This preserves the available image resolution and provides clearer, sharper visuals, particularly for screenshots and detailed tutorials.

Existing guide images will benefit automatically after upgrading. No re-uploading or additional configuration is required.

New:

What's new in 1.0.4​

• XenForo-style custom fields for guides
• Support for XenForo's standard text, choice and rich-text field types
• Global fields or category-specific field assignments
• Required fields, validation rules, choices and custom display templates
• Five display locations: above or below the introduction, above or below the steps, and in the sidebar
• Custom field support in both public and Admin CP guide editors
• Custom field values included in XenForo's native search index
• Improved category assignment validation and data consistency

Existing guides and categories remain unchanged after upgrading. No sample categories or fields are created automatically.

Update:

Custom guide fields for more flexible guide content​

Praxis Guides 1.0.4 introduces a XenForo-native custom field system designed specifically for guides.

Administrators can now create reusable guide fields, assign them globally or to selected categories, configure validation and required-field rules, and choose exactly where each field appears on the guide page.

Custom field values are available while creating and editing guides and are included in XenForo's native search index.

This release also includes additional category validation, data consistency improvements, and general refinements for XenForo 2.3.

Praxis Guides 1.0.3​

This update improves attachment compatibility for guide steps and ensures step-based media works more reliably with XenForo’s content linking system and compatible attachment tools.

• Improved step attachment content linking.
• Enhanced compatibility with attachment picker and attachment reuse workflows.
• Step attachments now resolve to the related guide step more cleanly.
• Minor internal refinement for XenForo content integration.

This is a recommended maintenance update for all customers.

What’s new in 1.0.2​

Praxis Guides 1.0.2 improves the add-on’s integration with XenForo’s native systems and prepares the package for smoother production use.

• Added XenForo native search integration for guides.
• Guide search now includes the introduction, step titles and step content.
• Added contextual search options for guide pages, including “This guide” and “This category”.
• Added approval queue support for guides.
• Added sitemap support for published guides.
• Improved default permission mapping on new installations.
• Improved attachment handling for guide steps.
• Improved release packaging so frontend assets are included correctly.
• Removed unrelated legacy integration files from the package.
• Updated compatibility requirement to XenForo 2.3.8+.

Upgrade notes​

After upgrading, XenForo will rebuild the Praxis guide search index automatically through its job system. If your server uses PHP OPcache, restarting PHP after uploading the new files is recommended.

Praxis Guides 1.0.1​

This update improves compatibility with the latest XenForo 2.3 releases and includes a few production-focused refinements.

• Improved compatibility with XenForo 2.3.8+ attachment and lightbox changes.
• Updated step image rendering to use XenForo thumbnail URLs instead of full direct image URLs.
• Added retina thumbnail support for step images where available.
• Added safer IP logging for guides, steps and comments to avoid errors when no valid request IP is available.
• Reviewed relevant XenForo 2.3.7 through 2.3.12 changes and confirmed Praxis Guides remains compatible with XenForo 2.3.12.

Upgrade note​

After uploading the new version, run the standard XenForo add-on upgrade process. If your server uses PHP OPcache, restart PHP/PHP-FPM or clear OPcache after upgrading.