XF 2.1 Porting TOC BB code add-on for XF2.1

[Slion]

I'm trying to port an add-on I developed 3 years ago for XF1.5 to XF2.1.
Here is the original thread about it:

TOC BB code add-on implementation

I'm trying to implement some BB code add-on that would build a Table Of Content for a post. I'm new to PHP and XenForo and have never implemented add-ons before. However I'm familiar with Perl and other web applications. I would like to publish the following BB codes: H1 to H6 and TOC. I got my...

xenforo.com

I don't think it's storing any data in the database. It is just parsing and rendering a bunch of BB codes really.
So I'm guessing I don't need a setup.

I ran xf-addon:create and told it to supersede an XF1 add-on. Now when looking at the CP it looks like that add-on is enabled but still listed as legacy.
I'm not sure what's the next step TBH.



Is there a guide on how to port such a BB code add-on from XF1 to XF2?

 

[Slion]

Went in the database and changed that is_legacy flag for that add-on in xf_addon table. Not sure I'm supposed to do that though.

 

[Slion]

Just checking how those are rendering here:

[h1]Header One[/h1]
[h2]Header Two[/h2]

 

[Slion]

With Class extension I tried something like that:

<?php

namespace Slions\Toc\XF\BbCode\Renderer;

class Html extends XFCP_Html
{

    public function addDefaultTags()
    {
        // This is an override so we need to call the parent function to preserve stock behaviour
        parent::addDefaultTags();
       
        // Add our new BbCode tags
        $this->addTag('h1', ['replace' => ['<h1>', '</h1>']]);
        $this->addTag('h2', ['replace' => ['<h2>', '</h2>']]);
        $this->addTag('h3', ['replace' => ['<h3>', '</h3>']]);
        $this->addTag('h4', ['replace' => ['<h4>', '</h4>']]);
        $this->addTag('h5', ['replace' => ['<h5>', '</h5>']]);
        $this->addTag('h6', ['replace' => ['<h6>', '</h6>']]);
    }
}

However for some reason it is not working as I would expect.
If I don't call the parent implementation it breaks all built-in BbCodes so that override is working.
However those H tag won't work for some reason.

I guess I have to use that Custom BbCode thing instead.

 

[Slion]

I got the basics working using those custom bbcode callbacks.
Though I'm not sure how to render them in the editor.

 

[Slion]

I eventually managed to get around publishing a first release:

Release v0.0.1 · Slion/XenForoAddOnSlionsToc

First public release

github.com

 

[Slion]

Slions - Table Of Content

Provides the following BB codes: TOC: For table of content placement. H1, H2, H3, H4, H5, H6: For various headings level. Editor buttons for headings and table of content. Supports WYSIWYG editor. Supports named anchor so you can reorganize...

xenforo.com