Skip to content

NodeBB v3 and Harmony Theme

Discussion
  • And now, something of a quandary. Given the imminent (well, Q2 2023) release of NodeBB v3 and the timed release of the Harmony theme that will ship with it - considering the hundreds of hours in terms of development I’ve invested in this new engine, do I

    I’m also looking for indications as to how many will jump onto the v3 train when it arrives - for example, I fully expect there to be a transition period, but is there any point in keeping the v2 theming engine afloat when v3 will render support for it obsolete at some point in future? I know v2 will be around for some time, but it can’t be infinite for obvious reasons - at some point, NodeBB will want to pull the plug on this as it will be considered legacy.

    Very interested in thoughts…

  • I’m also interested to understand migration timelines if you have (or have even thought about) them. What would be the amount of work and effort involved for you own sites? I expect a torrent of new CSS at the very least…

  • phenomlabundefined phenomlab referenced this topic on
  • For me, you have to abandon V2 or else you have to choose to stay on something that will be obsolete after a while or that will stabilize without major updates. Why not ? It’s a choice.

    For my part, I would like to upgrade to V3 either with persona on bootstrap5 which won’t change a lot in terms of design or switch to the Harmony theme which I find very beautiful and modern at first sight. I must see the theme in live and test it before take a decision.

    On the other hand, I already know that a lot of users will be disconcerted or even very surprised or will stop coming to the forum.
    There too it is a choice.

    – Personna or Harmony in V3, in both cases, it’s going to be a crazy job (less for Personna):

    • First of all, we will of course have to be sure that all the plugins we use work correctly with this version (or wait until they do, which would leave time to worry about other things)

    • That all the JavaScript and functions developed with Mark @phenomlab work like the Theme Switcher, the footerbar, the welcome message with change of the logo etc.) I will surely have to modify the code of all these functionalities according to Personna/Harmony/Bootsrap5 and I know @phenomlab will be there to help me. It is especially him who has the knowledge of the JS. I prefer CSS even though I’m not stupid

    • You will then have to code from scratch (if Harmony) or adapt (persona) all the CSS themes already present with the Switcher theme. In my opinion the ideal will be to start from scratch because a good part of the CSS classes will no longer exist and there will be new ones

    –> Anyway I would wait at least for the first stable release before coding anything in CSS or functionality.
    –> So by the time all the plugin devs update, harmony is fine-tuned and everything said above is coded correctly, it won’t be before the end of 2023 in my opinion that it will be in production without bugs.
    –> Of course all this will have to be done on a development VM. I just installed mine with nodeBB 3.0.0 alpha 3

    I expect a lot on the improvement of the chat system or the global chat plugin.
    It is a very appreciated function and not badly used on our forum (we like to discuss without going through other platforms)

  • @DownPW this is a great response, and it sounds very much like you’ve thought things though. I agree - it makes more sense to cease development of the v2 theming engine, and focus on v3.

    However, it’s worth noting that v3 (particularly with Harmony if I understood correctly) will also have the capability of switching themes - or at least, colour swatches, which is where I was originally heading with v2. It will be interesting to see how this materialises over time, given that the version in Persona seems to be something of an afterthought that doesn’t work very well either.

    The new Swatch capabilities skates for inclusion into Harmony may well render the custom theme switcher we developed obsolete if it offers a hook meaning it can be extended.

    From my perspective, all of my custom scripts will be updated to work with, and be fully supported in, v3. This is inclusive of the theme switcher (if applicable) and the custom footer etc.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    his is a great response, and it sounds very much like you’ve thought things though. I agree - it makes more sense to cease development of the v2 theming engine, and focus on v3.
    However, it’s worth noting that v3 (particularly with Harmony if I understood correctly) will also have the capability of switching themes - or at least, colour swatches, which is where I was originally heading with v2. It will be interesting to see how this materialises over time, given that the version in Persona seems to be something of an afterthought that doesn’t work very well either.
    The new Swatch capabilities skates for inclusion into Harmony may well render the custom theme switcher we developed obsolete if it offers a hook meaning it can be extended.
    From my perspective, all of my custom scripts will be updated to work with, and be fully supported in, v3. This is inclusive of the theme switcher (if applicable) and the custom footer etc.

    Personally, if the new swatch on harmony theme is just a color change, that wouldn’t suit me at all. Switching with CSS is just huge and much more functional
    We should also offer integration officially to NodeBB. that would be awesome 😉

  • @DownPW I’m running Harmony now on https://sudonix.dev 🙂 There is no swatch functionality from what I can see, so the code we developed is still up for the taking.

  • @DownPW I missed this - there is a skin switcher

    9f54e2bc-e717-4cae-a642-49c3d41d5238-image.png

  • @phenomlab Yep but that don’t work with css File ?

    I had tried in the past to create a theme with the official nodebb doc and I never succeeded

  • @DownPW I’ll need to look at the structure, but I can’t see why not.

  • @phenomlab

    I also see another problem with this selector : he display all the default themes.
    We should be able to remove all those present by default and display only those we need

    in addition as soon as you do a CTRL + F5 or refresh web page with F5, it removes the theme lol

  • @DownPW yes, I noticed that also. Looks like session data isn’t being retained.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    @DownPW I’m running Harmony now on https://sudonix.dev 🙂 There is no swatch functionality from what I can see, so the code we developed is still up for the taking.

    thanks for this one 👍
    I could check it more seriously…

  • Just looking through my code here, and provided that Persona as a NodeBB theme continues to be maintained, then the conversion of my code to v3 is a relatively simple affair meaning I could continue with my Swatch code without too much effort.

    Essentially, the move from v2 to v3 is basically the migration of bootstrap from v3 to v5. I suppose much of this depends on the future of Persona…

    EDIT - I’ll just leave this here
    https://community.nodebb.org/topic/16908/january-2023-developer-update/15?_=1673947070798

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    Just looking through my code here, and provided that Persona as a NodeBB theme continues to be maintained, then the conversion of my code to v3 is a relatively simple affair meaning I could continue with my Swatch code without too much effort.
    Essentially, the move from v2 to v3 is basically the migration of bootstrap from v3 to v5. I suppose much of this depends on the future of Persona…
    EDIT - I’ll just leave this here

    Do you think I could go through your swatch rather than the one I have?

    Because I don’t believe you released your code here. Whether ?

    Either way, I know I’ll have to start all over again in these 2 cases

  • @DownPW Yes, of course. However, because of the change of elements, I have to re-write most of it. In addition, only one theme will be supported - either Persona, or Harmony. If we go the Harmony route (which is highly likely) then virtually all of the swatch needs to be re-written including LESS etc.

    I don’t want to support more than one theme and would ideally stick to Harmony.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    Yes, of course. However, because of the change of elements, I have to re-write most of it. In addition, only one theme will be supported - either Persona, or Harmony. If we go the Harmony route (which is highly likely) then virtually all of the swatch needs to be re-written including LESS etc.
    I don’t want to support more than one theme and would ideally stick to Harmony.

    Yes indeed, we have to focus on one main theme and not two. (Persona or Harmony)

    I don’t yet have the opinions of the other members of my team but since it’s I who will then develop the themes compatible with Harmony, I think that we will go towards the road of Harmony

    If you are ready to share your codes once finished and explain how to use it, it’s really a good thing and I already thank you in advance 😉

  • @DownPW said in NodeBB v3 and Harmony Theme:

    If you are ready to share your codes once finished and explain how to use it, it’s really a good thing and I already thank you in advance

    More than happy to do so. In fact, BS5 makes it so much easier as LESS variables are being used, which we simply target and change. Far LESS (pun intended) work !

  • @DownPW I’ve started development work on Harmony in v3 and should have some beta code for you to test soon. Stay tuned!

  • @phenomlab Oh yeah very good news 😉

  • phenomlabundefined phenomlab forked this topic on
  • hello mark

    here is my tutorial for install V3.00 but it’s for alpha3.0 like you see in command.

    cd /path/to/your/nodebb
    git rev-parse HEAD  # save this value in case you need to roll back  
    git fetch && git checkout bootstrap5
    git reset --hard v3.0.0-alpha.3
    npm config set legacy-peer-deps true
    ./nodebb upgrade -mi
    ./nodebb build
    ./nodebb start
    

    – My questions :

    • How to know the name of the last version for V3 for install it (here is alpha.3) and adapt cli command above ?

    • How to upgrade the dev environment ? I know when Harmony it’s upgrade, we must upgrade boottrap 5

    – Here the command to upgrade bootstrap5 :

    git fetch && git checkout bootstrap5
    

    Many thanks


  • 2 Votes
    3 Posts
    147 Views

    Ah silly me, thanks for finding that!

  • 2 Votes
    2 Posts
    146 Views

    @cagatay this relates to a change the css classes used for the brand header meaning it will now float to the left instead of right.

    If you’d like to retain the original behavior, you can add this css class

    [data-widget-area="brand-header"] { justify-content: end; display: flex; }

    Further information here

    https://community.nodebb.org/topic/17090/manual-build-a-custom-header-in-harmony/19?_=1684069325296

  • 36 Votes
    55 Posts
    4k Views

    @DownPW I see why. The code relies on the existence of

    [component="topic/quickreply/container"]

    However, this by definition means that the below has to be enabled

    aeef638f-4188-489d-a9f2-f3a26dbca9d8-image.png

    It will then work

    7fb38631-e0f3-46ef-b652-00929d927b13-image.png

    For some unknown reason, this is hidden in Harmony, and only shows if you select it. In v2, it seems that the <section> is deleted altogether in Persona if “Quick Reply” is disabled, meaning it won’t fire as it can’t locate that specific component.

    The downside is that you might not want the quick reply function, but I think it’s a PITA to scroll up to the top of the post just to reply, so I have it on 🙂

  • 1 Votes
    2 Posts
    605 Views

    @eveh Welcome board 🙂

    The code you are referring to is custom written as no such functionality exists under NodeBB. However, adding the functionality is relatively trivial. Below are the required steps

    Navigate to /admin/appearance/customise#custom-header Add the below code to your header, and save once completed <ol id="mainbanner" class="breadcrumb"><li id="addtext">Your Title Goes Here</li></ol> Navigate to /admin/appearance/customise#custom-js and add the below code, then save $(document).ready(function() { $(window).on('action:ajaxify.end', function(data) { // Initialise mainbanner ID, but hide it from view $('#mainbanner').hide(); var pathname = window.location.pathname; if (pathname === "/") { $("#addtext").text("Your Title"); $('#mainbanner').show(); } else {} // If we want to add a title to a sub page, uncomment the below and adjust accordingly //if (pathname === "/yourpath") { //$("#addtext").text("Your Title"); //$('#mainbanner').show(); //} }); }); Navigate to /admin/appearance/customise#custom-css and add the below CSS block .breadcrumb { right: 0; margin-right: auto; text-align: center; background: #0086c4; color: #ffffff; width: 100vw; position: relative; margin-left: -50vw; left: 50%; top: 50px; position: fixed; z-index: 1020; }

    Note, that you will need to adjust your CSS code to suit your own site / requirements.

  • 5 Votes
    9 Posts
    903 Views

    is there any way to see whose reputation is changed by this plugin?

  • 4 Votes
    8 Posts
    2k Views

    @DownPW done

  • 3 Votes
    20 Posts
    936 Views

    @jac Exactly. Hard point to argue.

  • nodebb dropdown menu

    Solved Configure
    5
    0 Votes
    5 Posts
    418 Views

    @phenomlab said in nodebb dropdown menu:

    @kurulumu-net You set it like the below example taken from this site

    aae36790-3257-4bb2-ad5a-0d744309876a-image.png

    Which presents this

    77f47260-2941-4afe-9614-8e17dcfc8c19-image.png

    Very interesting…

    I actually thought this wasn’t possible, as I remember it being asked in the NodeBB forum.

    Is this something new that’s been implemented? I’ll 100% be doing that when I’m on the laptop over the weekend.