Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.8k Topics 26.5k Posts

Subcategories


  • User documentation for NodeBB

    44 Topics
    44 Posts
    Jay MoonahJ
    One of the first important things to do after setting up NodeBB is to set up an emailer plugin. While NodeBB does include a local emailer, if your forum is particularly active we recommend using an third-party emailer such as SendGrid which provides better deliverability for sites that send a high volume of email. Setting up SendGrid in NodeBB is very easy. Open the administrative dashboard using the 'gear' icon on your forum. Open the Extend > Plugins menu, and select the Find Plugins tab. Use the search on the right. Type 'SendGrid' and the plugin should appear -- select Install when you see it. From Installed tab on the Plugins menu, search again for 'SendGrid' and select Activate. Activating the plugin will require a restart of your forum. To restart, select the Dashboard menu and press the Restart button to the right. After NodeBB restarts, the SendGrid plugin will be active. After you restart, there should be a item called Emailer (SendGrid) under the Plugins menu -- if you don't see this right away, try refreshing your browser. Sign up to SendGrid Go to the SendGrid website, open the pricing page and scroll to the bottom. Click on the link and create your free account. Once you've confirmed your SendGrid account via email, you should be able to login to the SendGrid website. On the left side of your SendGrid dashboard, open Settings and click on API Keys. Click the button in the top right to create a new key. Make sure that the key has Full Access for Send Mail and Alerts.  When you are done, the new key to your clipboard. Now, return to the SendGrid menu on your NodeBB admin panel. Paste the API key into the field, and save your changes. Now go back to the Dashboard to restart your forum one more time. SendGrid should now be working for your forum. [image: youtubelogo.png] Setting up SendGrid mailer for NodeBB
  • NodeBB guides, how-to's and general tips and tricks

    83 Topics
    601 Posts
    Z
    not sure the plugin worked for firefox. saw a-z in the sort icon. when i used it, i expected the topics in the category would be sorted a-z. they werent
  • 25 Topics
    201 Posts
    eeeeeE
    I think you answered my point, by agreeing there are issues. I didn't even attempt to deploy nodebb, I had problems with much smaller projects! Nextjs routing was going through a change of design at the time, so perhaps that is less confusing now, but there were multiple other headaches. I would get build errors and issues with package management.
  • User field instead of username

    Moved
    2
    0 Votes
    2 Posts
    2k Views
    A
    Display Names aren't currently in NodeBB. Its not really something that has been requested that much. Considering you can change usernames.
  • How to use images in themes ?

    Moved
    8
    0 Votes
    8 Posts
    4k Views
    esiaoE
    @vatsal Yes I'm sure "folder-name" : "public/folder-name" means you can use /plugins/your-theme-name/folder-name/whatever The first parameter correspond to the name that will be used after theme-name/folder, while second parameter means this alias points to path.
  • Modifying the Lavender Theme

    Moved
    5
    0 Votes
    5 Posts
    4k Views
    S
    @baris Managed to find the following line <div class="<!-- IF categories.class -->{categories.class}<!-- ELSE -->col-md-3 col-sm-6 col-xs-12<!-- ENDIF categories.class --> category-item" data-cid="{categories.cid}" data-numRecentReplies="{categories.numRecentReplies}"> in ./node_modules/nodebb-theme-lavender/templates/home.tpl So I proceed to change it to <div class="<!-- IF categories.class -->{categories.class}<!-- ELSE -->col-md-3 col-sm-6 col-xs-12<!-- ENDIF categories.class --> category-item category-class-{categories.cid}" data-cid="{categories.cid}" data-numRecentReplies="{categories.numRecentReplies}"> ?
  • Accessing category children...

    Moved
    9
    0 Votes
    9 Posts
    4k Views
    T
    Thanks @esiao I've been wondering how this would look.
  • Copying Vanilla Theme

    Moved
    14
    0 Votes
    14 Posts
    7k Views
    julianJ
    Thanks for reporting the bug @mootzville, the templates property is no longer required in a custom theme's theme.json in v0.5.1 (but since we haven't even launched v0.5.0 yet, don't worry about a thing, the fix is backwards compatible)
  • Theme Question

    Moved
    3
    0 Votes
    3 Posts
    2k Views
    T
    I usually make a custom.less file and put all my edits in there with or without the !important tag, as needed. @frissdiegurke 's fix should work as well.
  • Using a script with Require.js support.

    Moved
    10
    1 Votes
    10 Posts
    6k Views
    J
    @psychobunny I added you for a collaborator on my github project so there you can see everything you need.
  • Adding theme options to the ACP.

    Moved
    3
    0 Votes
    3 Posts
    2k Views
    A
    @psychobunny Collaboration.
  • Full featured themes and compatibility?

    Moved
    8
    0 Votes
    8 Posts
    3k Views
    P
    @pwFoo sagte:> @a_5mith Vanilla has some little bugs Topic overview page and topics are clean and clearly arranged. Looks good! But often I have to reload the page (browser reload button) to load all styles... seems to be a bug. Lavender seems to work stable. After clear browser cache and node app / nodebb upgrade most bugs away... Still there and so should be a bug. Copyright overlays category blocks with Cerulean and Vanilla theme, but should be at the bottom of the page. Both view of topic list and single topics is fine. Maybe I have to find out how to tweak / change the home page (categories overview).
  • Created a new theme, now what?

    Moved
    18
    1 Votes
    18 Posts
    8k Views
    A
    @julian If you view his avatar in a new tab, he has a cool tattoo.
  • Template Logic Question

    Moved
    10
    0 Votes
    10 Posts
    5k Views
    barisB
    It is loggedIn everywhere now. https://github.com/NodeBB/NodeBB/issues/1900
  • Need some advice on theme creation

    Moved
    3
    1 Votes
    3 Posts
    2k Views
    R
    @psychobunny with regards to your suggestions on stripping out features, I'll have the devs take a look at the disabling options you pointed out. Integrating with my application: We have integrated to some degree using the SSO plugin and hopefully it will continue to be as problem free. We are integrating this with a custom Laravel application. I am really not keen on using iFrames and would prefer a proper theme integration but if push comes to shove, I guess I'll have to settle for an iFrame integration. At this stage, we're doing development in-house but of course if we run into issues I will shoot you guys an email. As for the theme design, I will definitely keep @trevor in mind. I have looked at his work and it does in fact looks very nice. I really appreciate you taking the time to reply to me and give me your advice on where to start looking; it is very appreciated. Regards
  • So I want to create a theme.

    Moved
    1
    0 Votes
    1 Posts
    1k Views
    esiaoE
    Hello NodeBB users. Since I've chosen NodeBB to replace my current free hosted and created forum I need to create the custom theme that will go with it. Since it's a graphic community we have some features needed and that's why I've taken a look at plugins and the API to see if NodeBB is ready to answer our problematic. Mostly it's the case and the modular aspect is very appreciable. So first question, how to do a child theme ? I've the quickstart theme and it seems that only importing the less of another theme do the job. (Vanilla in that case). But for instance if I want to use Lavander that is a lot more developed is that the same way ? Isn't that a bit ugly cause I assume it will be CSS replacement over imported CSS with new one too. Is there a best way to do it ? Is a theme capable of interacting on templates and add features to the control panel like a plugin. For instance I absolutely need the sub category feature, because my forum today use a structure like : Category Forum Sub forum Sub forum Archives (occasional) So there's at least 3 levels needed and I'll need to figure out if there's a way to do so since it doesn't seem implemented in the actual NodeBB version. Is it possible to add a new navigation, I think it's possible with a widget it doesn't seem like there's an existing one I might take a look on this. I think this is not theme related so I'll stop here but these are the direct questions I have. Also I doesn't seems that this forum have a support category, I think it could be nice to add one in order to filter actual themes from requests/question ect... (same for plugins).
  • Here's a helpful CSS cheatsheet!

    Moved
    3
    9 Votes
    3 Posts
    3k Views
    T
    @julian Believe it or not, but I've never went there before for CSS reference, but I'll read up on it further here since of course they are the "authority" in web standards.
  • Some questions

    Moved
    2
    0 Votes
    2 Posts
    1k Views
    T
    Could it have something to do with the custom-homepage plugin overriding the home.tpl template? Perhaps, but I'm not totally sure. The way I place widgets is I just take whatever is a widget template and copy and paste it into one of the main theme templates such as topic.tpl or category.tpl. So for example, the popular tags widget (which I have not used yet but will soon), looks like this. <!-- BEGIN tags --> <a href="{relative_path}/tags/{tags.value}" class="pull-left"> <h4> <span class="label label-info">{tags.value}</span> <small>x</small><span class="tag-topic-count">{tags.score}</span> </h4> </a> <!-- END tags --> I take that and place it somewhere (anywhere) I want it to render in a template. -_- Another example is using the widget-area as shown here using the "active users" widget (this is for category.tpl); [image: RMrUaSw.png] And the HTML is as simple as this; <div class="category-active-users"> <div widget-area="sidebar"></div> </div> Whatever is placed in widget area named "Sidebar" in the ACP, is what will render here. For this I have simply used the "Active Users" widget block as shown below. [image: 2iChev7.png] All in all, its a matter of preference of how you want to do things.
  • I want to change "said" to other language, what files should I modify?

    Moved
    5
    0 Votes
    5 Posts
    2k Views
    HentaiH
    @a_5mith Me too ...
  • What does this folder do?

    Moved
    4
    0 Votes
    4 Posts
    2k Views
    julianJ
    @helltux is currect, it is for Right-to-left languages, like Persian, Arabic, etc. Those CSS rules are not applied to regular languages. I believe it specifically looks for a data-rtl attribute in the body tag.
  • I want to delete this button,what files should I modify?

    Moved
    3
    0 Votes
    3 Posts
    2k Views
    HentaiH
    @a_5mith Thanks for your advice : )
  • A resource some of you may find useful.

    Moved
    11
    2 Votes
    11 Posts
    4k Views
    meetdilipM
    I often get confused with those names. Lavender good in many ways compared to Vanilla. Especially the recent update made it better.
  • panel resizer 100%

    Moved
    5
    0 Votes
    5 Posts
    2k Views
    G
    thank you all! @baris @psychobunny