xF2 Tabbed Options

[ven0m]

Heisenberg submitted a new resource:

You must be registered for see links

- Tabbed Options

This guide will allow you to have a single option group for all your options, separating them into tabbed sections rather than forcing users to change option groups.

Examples

You must be registered for see images

You must be registered for see images

Code Event Listener
Event: templater_macro_pre_render
Event Hint: adminption_macrosption_form_block
Execute Callback:...

You must be registered for see links

 

[ven0m]

Heisenberg updated

You must be registered for see links

with a new update entry:

You must be registered for see links

Alternative macro HTML in order to create full-width separators instead of tabs.

<xf:macro name="option_form_block" arg-group="" arg-options="!" arg-containerBeforeHtml="">
    <xf:if is="$options is not empty">
        <xf:form action="{{ link('options/update') }}" ajax="true" class="block">
            {$containerBeforeHtml|raw}
            <div class="block-container">
                <h3 class="block-formSectionHeader">
                    {{ phrase('general_options') }}...

You must be registered for see links

 

[ven0m]

Heisenberg updated

You must be registered for see links

with a new update entry:

You must be registered for see links

Fix: Updated function arguments for the code event listener​

You must be registered for see links

 

[ven0m]

Heisenberg updated

You must be registered for see links

with a new update entry:

You must be registered for see links

Alternative macro HTML in order to create full-width separators instead of tabs.

<xf:macro name="option_form_block" arg-group="" arg-options="!" arg-containerBeforeHtml="">
    <xf:if is="$options is not empty">
        <xf:form action="{{ link('options/update') }}" ajax="true" class="block">
            {$containerBeforeHtml|raw}
            <div class="block-container">
                <h3 class="block-formSectionHeader">
                    {{ phrase('general_options') }}...

You must be registered for see links

 

[ven0m]

Heisenberg updated

You must be registered for see links

with a new update entry:

You must be registered for see links

I've updated the macro HTML code and included code for both tabbed and spaced options, with default being spaced, due to compatibility.

Furthermore, the display orders now split every 1000, instead of every 100, and adds support for the <hr class="formRowSep" /> every 100 just like standard XF2 options.

If you are using this code in your addon, you should not simply paste this new macro code without also fixing all your options to multiply their display order by 10.

You must be registered for see links

 

[ven0m]

Resource has been updated

You must be registered for see links

with a new update entry:

You must be registered for see links

If you use this in your add-on, you probably use it in multiple. Changing the template is a pain for each of them, so now the template has been made 100% universal, with the configuration switched to the PHP code.

I've also updated the guidelines for the listener to use a single Listener.php file instead of a new file per listener, it doesn't really matter but it's a standard I use so

You must be registered for see links