How do I add widgets? I can't seem to understand documentation.

[v5rm]

First off this looks amazing, but I can't seem to understand the documentation.

I'm trying to add the calendar widget. Where should I place the code snippet shown on that page?

I tried figuring that out by going to the widget page, and added this code snippet to my services.yaml.

- calendar:
  - calendar:
    widget:
      type: calendar

And that did nothing. I also tried various iterations of adding and removing icons, hrefs, and descriptions.

I tried asking the ai chatbot, and it told me to add the code snippet to homepage.yaml, which I found no reference to in the documentation. I still made the file and added the code, and that didn't work.

I've also tried a bunch of random things which I can't fully list, but nothing worked. Can someone tell me how I should do this, and where in the documentation this was explained, since there's some part of the documentation that I'm not reading correctly.

[adm2k]

Widgets go in the services.yaml. Your code snippet seems to be missing much information, see this link for information:

https://gethomepage.dev/v0.8.2/widgets/services/calendar/#monthly-view

[GetOutOfMyBakery]

@adm2k is right to point you to the calendar docs, but I think you're also looking for a bit more help for a first time user.

If you check out the configuration docs, you'll see that there's a section for each part of the configuration, and each of them have a specific .yaml file associated.

Here's how my config/ directory looks:

$ tree config
config
├── bookmarks.yaml
├── custom.css
├── custom.js
├── docker.yaml
├── kubernetes.yaml
├── logs
│   └── homepage.log
├── services.yaml
├── settings.yaml
└── widgets.yaml

There's no homepage.yaml, it's not a valid file here.

Also on the configuration docs, note first tip on using yaml:

1. Use Indentation Carefully: YAML relies on indentation, not brackets.

It looks like the problem you've got is indentation.
When I use your snippet (in services.yaml), here's how it looks for me:

When I update the indentation:

- calendar:
  - calendar:
      widget:
        type: calendar

Here's how it looks now:

[v5rm]

Thanks! I think I may have screwed up some of the other config files as well when playing around with it originally, but I did a complete reinstall and updated the indents and now it works.

[Anthony2410]

If it's supposes to go in the services.yaml, why is the chat AI telling me to put it in widget.yaml?

[Anthony2410]

I don't know what you mean by post a link, but the question I asked was "Where do you place the calendar widget?".

[Anthony2410]

Also, the page https://gethomepage.dev/latest/widgets/services/calendar/#monthly-view doesn't tell you were to put the widget and doesn't tell you under what to place the code snip-it displayed as an example.

[shamoon]

After you ask the bot a question theres a link to "share" it which links to the specific question / answer

[Anthony2410]

#2503

[Anthony2410]

Thank you for your help with the issue.

[github-actions[bot]]

This discussion has been automatically closed because it was marked as answered.

[github-actions[bot]]

This discussion has been automatically locked since there has not been any recent activity after it was closed. Please open a new discussion for related concerns. See our contributing guidelines for more details.