Login
Channel Apps
Channel About Photos Files Calendar Webpages Wikis
System Apps
Directory Help Language Public Stream Random Channel Report Bug Search
Please read the Code of Conduct that applies for this forum:
Click to open/close

The Code of Conduct of Hubzilla.org (Version 22 June 2024)

In all publications and interactions on Hubzilla.org, we ask you to cultivate and demand respectful interaction with one another and to be aware of the consequences of your actions (in relation to the world and the future).

Your'e asked to behave in a way that enables all users and visitors of Hubzilla.org to participate (to inform, to get informed, to discuss, to develop, to create) without harassment, regardless of age, body size, disability, ethnicity, gender characteristics, gender identity and expression, level of experience, education, social status, nationality, personal appearance, race, caste, skin colour, religion or sexual identity and orientation.
We ask you to act and interact in a way that contributes to an open, welcoming, diverse, inclusive and healthy community.

These are examples of behaviours that contribute to a positive environment for the community:
  • Show empathy and kindness towards everyone
  • Respect different opinions, points of view and experiences
  • Give constructive feedback
  • Accept constructive feedback with dignity
  • Take responsibility
  • Apologise to those affected by your mistakes
  • Learn from experience
  • Focus on what is best not only for you as an individual, but for the community as a whole

The following behaviour will result in your channel being blocked:
  • You use sexualised language, images or symbolism
  • You make an unwanted sexual advance
  • You make offensive or derogatory comments
  • You attack someone personally or politically
  • You engage in trolling
  • You harass someone, whether publicly or privately
  • You publish other people's private information without their express permission
  • You display behaviour that could reasonably be considered inappropriate in a professional environment

The board of directors of the Hubzilla Association will remove posts and comments that do not comply with this Code of Conduct and block their author.

This Code of Conduct applies to all content published in a channel which is hosted on hubzilla.org, even if the channel is a private one (a closed circle).
Different ways to contribute:
Click to open/close
At hubzilla.org/page/info/get_involved you will find an overview of the different ways to contribute to the project.

This forum here is the right place to collaboratively discuss improvements to the user documentation, its translations and the creation of user tutorials.

If you are looking for support as an admin, you will find the right forum at hubzilla.org/channel/adminsforum

If you want to help develop the code, you can find the right forum at hubzilla.org/channel/development

Hubzilla Documentation Team
documentation@hubzilla.org
Harald Eilertsen Harald Eilertsen wrote the following post 2026年6月29日 17:04:21 +0200

Update Superblock translations

Hi,

I'm getting ready to merge the next version of Superblock (likely version 3.1), and have now updated my WIP branch with the latest strings and documentation changes. Let me know if anybody wants to help update the existing translations, or provide translations to yet another language.

If you already have a dev instance set up, it should be easy enough to check out the WIP branch of the addon repo. But let me know if you need help.

Otherwise, you can also just unzip the attached zip-archive to a clean directory on your system, and do the translation there.

I recommend POEdit to help with the translations, but it's also possible to just edit the files in your favourite text editor.

Let me know if you need any help, and I'll assist as well as I can.

Thanks in advance for any help!

Harald Eilertsen
harald@hub.volse.no
I have removed the DRAFT marker for this MR now, so it's ready for Mario to review, and merge when he has the time.

I'm still hoping we can get the strings and updated docs translated before it's released though. Let me know if you'd like to contribute, but wants some help to get started.

Hubzilla Documentation Team
documentation@hubzilla.org
Der Pepe (Hubzilla) ⁂ Der Pepe (Hubzilla) ⁂ wrote the following post 2026年6月12日 15:01:28 +0200

Developer documentation (develmanual)

In my view, the basis of the current developer’s guide is quite decent (perhaps a few typos need sorting out here and there... for example, the section on the file system hierarchy is completely out of date, as well as the list of hooks).

Generally speaking, I think the manual is aimed at developers who want to extend Hubzilla. Debugging and extending the core are in a completely different league. For that, one could potentially provide a complete source code documentation (e.g. created with Doxygen)... or those who really want to delve into the inner workings can generate it locally themselves. One should be able to expect that level of technical knowledge from someone who wants to code directly on the system.

The focus of the manual should therefore be, following the (already existing) basic information, on the development of add-ons and widgets, as well as the development of themes and everything that goes with them. That is something which, in my view, belongs in this manual. For ‘system tinkerers’, just the basic pointers on how to approach the subject.

I would keep the section on setting up Hubzilla in a virtual machine for development purposes in the manual, but personally I think development is easier to achieve with DDEV. That is why I would recommend this method and also include a few words on debugging using Xdebug.

The creation and translation of the documentation should also remain in the manual.

I started revising this manual a short while ago.

Harald Eilertsen
harald@hub.volse.no
Looks like a good plan!

I agree that keeping the focus on developing addons, themes and widgets is the most important. To be fair, most of core is built using the same patterns and functions as well.

Finding a good way of documenting the hooks is probably going to be the most challenging. There's a ton of them, and they're a bit unwieldy to handle automatically. At least with doxygen. We may perhaps want some custom tooling for that.

Hubzilla Documentation Team
documentation@hubzilla.org
Harald Eilertsen Harald Eilertsen wrote the following post 2026年6月10日 13:19:06 +0200

Updated translated templates for registration email verification

I've updated the translations for the template used to generate the verification emails on account registration. Several of the translations had old and outdated links resulting in blank pages, and no useful information. Frustrating for the prospective new user, and for the site admin.

It would probably be good for translators to revisit these templates, as I'm not that much of a polyglot, so I've only updated them with English text.

See https://framagit.org/hubzilla/core/-/merge_requests/2291 for the updates. If you want to update the translation before the MR is merged, feel free to send me the updated files in a PM or something.

git64bit
git64bit@directory.diagnostics.kane-il.us
While installing my node I had some difficulties with the initial login. I think there is a circular dependency where the installation is not yet finished, not at the point where the email service configuration may take place - so the registration info for the first (admin) account cannot be sent. You can hack the MariaDB table which is what I did, but I believe email verification should be at least suspended during the first registration.

I use a MTA not anything PhP, so for those who use PhP Mail this might not be an issue at all.
git64bit
git64bit@directory.diagnostics.kane-il.us
I use my own stack for everything, from DNS all the way to the top. Sendmail, php mail works, I know. But its a hassle to use them then turn them off once you switch to the MTA. In either case the installation is not user friendly with the very first account creation interrupted by mandatory verification. This is an old issue, by the way, and if I recall it correctly it remains an issue on the Streams fork as well.

Hubzilla Documentation Team
documentation@hubzilla.org
Ema エマ Ema エマ wrote the following post 2026年3月17日 03:51:30 +0100

Navigation in aside region for translations

@Der Pepe (Hubzilla) ⁂ while the english version of the documentation has a nice collapsed overview of the documentation navigation in the aside region, the german translation doesn't have that. Could you please have a look into it?

Screenshots:

english.png

german.png

Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team I’ll have a look. But that’s not really "my area of responsibility". I’m not entirely sure how the help texts are displayed. I formatted the German documentation so it could be integrated (following @Harald Eilertsen 's instructions). The different layout in the sidebar seems to be more a matter of the template.

Hubzilla Documentation Team
documentation@hubzilla.org
Ema エマ Ema エマ wrote the following post 2026年3月17日 03:46:59 +0100

Include How-to for creating new widgets into the documentation

@Der Pepe (Hubzilla) ⁂ could you please include this somewhere in the documentation? Maybe under Tutorials? #^https://web.archive.org/web/20250718234307/https://completehostingguide.com/article/creating-new-widgets-in-hubzilla

Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team @Ema エマ

I’ll have a look at the best way to integrate this (I’ve quickly saved the page locally for now, as Scott’s pages aren’t always accessible).

Hubzilla Documentation Team
documentation@hubzilla.org
Ema エマ Ema エマ wrote the following post 2026年3月17日 03:45:12 +0100

Rewrite the Comanche section in the documentation

@Der Pepe (Hubzilla) ⁂ Could you please rewrite the Comanche section? I see following two problems: (1) template names are not mentioned explicitly, we have delusive headers "Standard template" and "Full template" instead. We should get rid of these delusive headers and put the template names instead. Pay attention to keep these names unchanged in the translations of the documentation. (2) This chapter is not divided well into its parts. We should divide them well into subchapters. Here's my suggestion, where I implemented the subchapters as h3 headers. From "Navbar" on, it can remain unchanged. Attached is a text file with the raw bbcode.

Page templates

There are currently five layout templates, unless your website offers additional layouts. The template names are default, full, choklet, redable and zen. To select a template for your custom layout, use the ‘template’ tag in the first line of your layout, i.e. [template]full[/template]. The default template is used if no other template is specified.

default


The default template defines a ‘nav’ area at the top, ‘aside’ as a sidebar with a fixed width, ‘content’ for the main content area and ‘footer’ for a page footer.

full


The full template corresponds to the default template except that there is no ‘aside’ area.

choklet


The Choklet template offers six different flavours of layout styles. I.e., to select the template ‘choklet’ with the flavour ‘three’, use [template=three]choklet[/template].

  • (default flavour) - a two-column layout similar to the default template, but more flexible
  • bannertwo - a two-column layout with a banner area, compatible with the default template on small displays
  • three - three-column layout (adds a ‘right_aside’ area to the standard template)
  • edgestwo - two-column layout with fixed margins
  • edgesthree - three-column layout with fixed margins
  • full - three-column layout with fixed margins and the addition of a ‘header’ area below the navigation bar


redable


A template for reading longer texts in full screen mode (i.e. without a navigation bar). Three columns: aside, content and right_aside. For maximum readability, it is advisable to use only the middle content column.

zen


Gives you the freedom to do everything yourself. It is just a blank page with a content area.

Regions


Use ‘region’ tags in your custom layout to decide what content should be placed in which regions. Three ‘macros’ have been defined for your use.

$htmlhead places the site head content into your layout.
$nav places the site navigation bar content into your layout.
$content places the content which is defined in the page created under /webpages//

By default,
$nav
is inserted into the ‘nav’ page area and
$content
into the ‘content’ area. You only need to use these macros if you want to change the order of the elements or move them to other areas.

Themes


To select a theme for your page, use the ‘theme’ tag.

[theme]suckerberg[/theme]

This selects the theme ‘suckerberg’. By default, the theme preferred by your channel is used.

[theme=passion]suckerberg[/theme]

This selects the theme named ‘suckerberg’ and chooses the ‘passion’ scheme (theme variant). Alternatively, it is also possible to use compressed theme notation.

[theme]suckerberg:passion[/theme]

The compressed notation is not part of Comanche itself, but it is recognised by the Hubzilla platform as a theme specifier.

Fill your custom page template with content


Navbar


...

Ema エマ
ema@utasansh.in
The attachment is not showing in the post. This issue needs to be fixed, @Mario Vavti. I posted by visiting the @Hubzilla Documentation Team channel.

@Der Pepe (Hubzilla) ⁂ Here's the attachment: #^https://hubzilla.org/attach/c5d0b3ad-054b-4600-b65a-a108340e8d3e
Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team OK, I’ll do that right away.
Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team @Ema エマ

Should I also insert my graphic for the various regions at the appropriate place in the document?

regions.webp

Hubzilla Documentation Team
documentation@hubzilla.org
Harald Eilertsen Harald Eilertsen wrote the following post 2026年2月19日 22:14:02 +0100

Inspect queue - expert mode

Hoi,

While scourging the code to try to figure out how to debug the issues I had with my hub after the upgrade to 11.0, I came accross this nugget which may not be known to many:

There's an "expert mode" when viewing the the outgoung queue in /admin/queue. Add ?expert=1 to the URL, and you will get some extra options and controls. Like this:

/admin/queue?expert=1

Screenshot of admin/queue view in "expert mode".

The buttons allow you do mark the site as permanently offline, empty the queue for the given site or retry delivery right away.

Once you have made a choice, the page will reload in normal mode, so if you want to process any more entries you have to enter the query param again.

This can probably be made smoother, and given a better UI, but I thought it could be interesting to the documentation team in any case.

Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team I can't believe it! 😂

I requested this exact feature a long time ago. They said that undeliverable entries would be deleted after a certain amount of time and unreachable instances would be added to the ‘unreachable list’ after an even longer period of time.

I had asked for exactly that because I knew it from (streams) – when I had installed such a hub – from the queue view there.

queue1.png

That's brilliant! I'll add it to the documentation and my KnowledgeDB.

You've made my day with this discovery.
Jupiter Rowland
jupiter_rowland@hub.netzgemeinde.eu
Hubzilla is when even the main devs keep discovering hidden features they knew nothing about.

Hubzilla Documentation Team
documentation@hubzilla.org
Ema エマ Ema エマ wrote the following post 2025年7月28日 03:55:16 +0200

Feature request for a searchable documentation created

I just created the feature request for a searchable documentation.
#^https://framagit.org/hubzilla/core/-/issues/1919
@Harald Eilertsen @Mario Vavti

Saiwal
sk@utsukta.org
@Hubzilla Documentation Team the documentation can be searched with a ? prefix from the search bar.

Hubzilla Documentation Team
documentation@hubzilla.org
Ema エマ Ema エマ wrote the following post 2025年7月28日 02:54:44 +0200

Add explanation for OCAP acess setting

see #^https://hub.netzgemeinde.eu/item/d9d19ac0-2ce6-41f0-b39a-5b4cbd56662e

to be done
@Der Pepe (Hubzilla) ⁂ ⚝
Thank you

Der Pepe (Hubzilla) ⁂
pepecyb@hub.hubzilla.hu
@Hubzilla Documentation Team
to be done

It's on my to-do list for today! 😉

Hubzilla Documentation Team
documentation@hubzilla.org
Harald Eilertsen Harald Eilertsen wrote the following post 2025年7月24日 13:28:25 +0200

Updated tutorial for developing a derived theme

I've started updating the tutorial on developing a derived theme (along with some core fixes to make that actually work.)


Not sure if this actually needs to be translated, but it's there if anyone wants to :) Any other feedback is also appreciated. I'm planning to expand it further by more lessons as I go through and discover how different things are done.

The current version relies on the changes in !2217 so it requires the dev branch for now.

AltStyle によって変換されたページ (->オリジナル) /