Group Timezones

Customization Theme component

AI-generated summary

The Group Timezones theme component has been deprecated, and its functionality is now included in the Discourse Calendar and Event plugin.

The component was used to display people of a group in a timezone ordered list, showing who is on holiday/weekend/out of working hours. However, due to the deprecation, users are advised to use the calendar plugin instead.

Initially, users reported issues with displaying the timezone ordered list using the calendar plugin, but it was later discovered that the functionality is available using the format [timezones group="GROUP" size="big"]timezones[/timezones]. However, eve reported that this format didn’t work in their instance, but the original [wrap=group-timezones group=project-x-team][/wrap] format started working again.

The issue was likely due to the timezone user field moving to the core and requiring an update to the component. joffreyjaffeux acknowledged the need to deprecate the component, and Osama fixed a reported issue with the component breaking on 2.7.0.beta7.

Users are advised to use the calendar plugin and refer to the documentation for the correct format to display the timezone ordered list.

1

:warning: This theme component has been deprecated and its functionality is now included in the Discourse Calendar and Events plugin
:discourse2: Summary Group Timezones can help you display people of a group in a timezone ordered list. It will also show who is on holiday/week-end/out of working hours.
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-group-timezones
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Features

22
221524×472 68 KB

This is useful for people using Discourse with a remote and distributed team to work on projects.

Usage

:warning: This plugin relies on the timezone field of a User being set. This field is available at the moment only when using discourse-calendar, so you need to have this plugin to use this component.

[wrap=group-timezones group=project-x-team][/wrap]
  • group is mandatory
  • size is optional and accepts: small, medium, large, auto

Settings

Name Description
working day start hour When the working day starts
working day end hour When the working day ends
close to working day hours extension How many hours around start/end working hours are acceptable if urgent to get in contact with someone
working days Which days of the week are worked
Translation Default
search Search…
group_availability %{group} availability
32 Likes
Is it just me, or is Hyperscript hideous?
Available hours / work hours flair
2

That’s a co-incidence @j.jaffeux because I was playing around with a visualisation for timezone overlap recently:

Love it, thanks!

14 Likes
3

Hi there! Does this theme component still work and/or is it still supported, or fully deprecated in favor of the calendar plugin? I tried using the markup in a topic with and without the calendar plugin enabled, but got a blank rendering each time.

Trying to tell if there’s still an existing (simple) way to display this TZ slider or something close to it.

1 Like
4

I think that is because the calendar plugin is a hard requirement?

But since that I think we moved the timezone user field to core… So it may need an update to work with that.

5

Yes it’s inside calendar I think now right, I should deprecate this. Forgot about it as I didnt do the move.

2 Likes
6

This theme component seems to break on 2.7.0.beta7 with

Uncaught Error: Could not find module `discourse/lib/round-time` imported from `discourse/theme-72/widgets/discourse-group-timezones`
3 Likes
7

Thanks for reporting, I know what issue it can be, will fix tomorrow unless @Osama beats me to it.

4 Likes
8

Fixed in:

https://github.com/discourse/discourse-group-timezones/commit/3c82f4b6c04bafc6536d129130d8a097a83a1e26

Thanks for letting us know!

6 Likes
9

Is this still possible using just the calendar plugin?

The README of this component says:

DEPRECATED: This component is no longer necessary; all functionality has been moved into GitHub - discourse/discourse-calendar: Adds the ability to create a dynamic calendar in the first post of a topic. · GitHub

Unfortunately i can’t figure out how to set up this view:

grafik
grafik517×159 9.34 KB

11

Hmm. Good shout. It seems we may not have updated the docs on this point. Let me see what I can find out.

@eve After a small explore, it seems this is possible to add to a topic using only the Calendar plugin using the format:

[timezones group="GROUP" size="big"]timezones[/timezones]
1 Like
12

Thanks for taking a look!

[timezones group="GROUP" size="big"]timezones[/timezones]

This doesn’t work in our instance. But somehow the format

[wrap=group-timezones group=project-x-team][/wrap]

mentioned in the first topic now works. Yesterday nothing showed up. :person_shrugging:

1 Like
13

I’m glad it’s working :slight_smile: Though it’s odd we’re getting different results. What version of Discourse are you using?

14

I’m running with 3.3.0.beta3-dev ( f0539afb02 )