tpl files for widgets

2025-06-09 23:15:49

adminsforum@hubzilla.org

𝓒𝓱𝓻𝓲𝓼 wrote the following post Mon, 09 Jun 2025 23:16:15 +0200

tpl files for widgets

for some widget there are a tpl file under /view/tpl for other there is not . for e.g can´t finde one for the tag widgets.

Why?
How does this work?

show all 16 comments

2025-06-10 00:13:31

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼 Some modules, widgets etc just generate the html themselves without using a template. Also there are generic templates that can be used by several widgets. Check the code of the widget you want to change/replace.

2025-06-10 01:14:30

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen thanks

2025-06-10 08:46:27

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen so how the overwrite would work if i want to adapt a widget for a theme and don´t find a tpl fiele ?

2025-06-10 09:46:21

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼 Let's have a look...

For Zotlabs\Widget\Tagcloud we have:

 $r = tagadelic($uid, $count, '', '', $flags, 0, $type);
  
 // @FIXME this should use a template
  
 if($r) {
    $o = '<div class="tagblock widget"><h3>'
       . t('Tags') 
       . '</h3><div class="tags" align="center">';
    foreach($r as $rv) {
        $o .= '<span class="tag' . $rv[2] '">' 
            . $rv[0] .' </span> ' 
            . "\r\n";
    }
    $o .= '</div></div>';
 }
 return $o;

So, it's just creating the HTML directly. (But note the @FIXME tag. You could add a template for it if you want.) Luckily the generated HTML is pretty clean and straight forward with meaningful css class names, so you could simply add the appropriate styling to your stylesheet.

If you want to modify the markup as well, you would have to add your own widget. Hubzilla will look for widget classes in your themename/widget subdirectory, but will do so after checking the built in location (Zotlabs\Widget), so you will have to use a unique name that don't clash with the built in widgets.

Imo, it would make sense to swicth this logig around, so that we search addons and themes before the built in widgets, so that they can be overridden by custom themes and addons.

2025-06-10 12:10:41

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen THANKS for explaining - i will try it that way

2025-06-10 13:13:20

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen

in
Zotlabs\Widget\Tagcloud_wall

i do not see this html code

my thought was to edit the code of the widget so that is works as a collapse element

https://getbootstrap.com/docs/5.3/components/collapse/

were to put this bootstrap html code ?

2025-06-10 14:18:51

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼 That's right, that's a different widget.

 return wtagblock(\App::$profile['profile_uid'], $limit, '', 
    \App::$profile['channel_hash'], 'wall');

Iow, we need to look for the wtagblock() function, which is in include/taxonomy.php. There you will find code that's very similar to the other widget. (Looks like a golden opportunity for some refactoring.)

This also means you're probably out of luck if you want to change the markup (unless you want to suggest the change to core), but if all you want to do is fix the styling, you still should be able to do that from the css files.

2025-06-10 15:35:19

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen thank you for explaining - I think i'm out of luck , /taxonomy is too much for my understanding -

2025-06-10 15:55:47

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen
so i have here an other one:

/Zotlabs/Widget/Archive.php

how does this one work - i want to change the output form a list to a cloud-wall view... any chance?

2025-06-10 18:01:47

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼
The template is in view/tpl/posted_date_widget.tpl. In this case you can override it by placing a file with the same name in your theme's tpl directory.

2025-06-10 18:23:46

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen THANKS... great !

it would be easier if the .tpl file name would be the same as the widget file name ;-)

2025-06-11 13:02:09

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen looking in to

Zotlabs/Widget/Archive.php

and reading

/help/en/Widgets

archive - date range selector for network and channel pages
args: 'wall' - 1 or 0, limit to wall posts or network/matrix posts (default)

i tried

[widget=archive] [var=wall]1[/var][/widget]

but this seams not make a difference to the default network/matrix posts .

Here it does just work with channel wall posts.

With /articles it does also not work.

But in the code i read in line 31 something about articles - can you explain what the code is suppose to do with articles?

THANKS

2025-06-11 14:55:39

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼 The wall argument is ignored. Not by the widget itself, but the functions in core used by the widget.

2025-06-11 22:09:40

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen and what about the articles function... is it also ignored ?

2025-06-12 00:00:27

Harald Eilertsen

harald@hub.volse.no

@𝓒𝓱𝓻𝓲𝓼 Most likely if it uses the same functions.

2025-06-12 08:30:59

𝓒𝓱𝓻𝓲𝓼

chris@im.allmendenetz.de

@Harald Eilertsen Ok the widget does work also with articles !! but there is a bug - maybe you can help to fix this.

If we are on a specifi /articles page of an item like

/articles/[channel]/[mid]

and we start a search/filter with the help of the archive widget - the search/filter will not show any results.