lochmueller / calendarize

📆 Best TYPO3 Calendar ever 📆
http://typo3.org/extensions/repository/view/calendarize
74 stars 84 forks source link

Developer Documentation - is there a programmer guide or sample Ext? #797

Closed geri777 closed 6 months ago

geri777 commented 6 months ago

First of all thank you very much for that great extension. It has so many great features out of the box. However as I need a larger data model, I started implementing my own Event Table with a new Extension. I soon got stuck, because I can't find any information on the Calendarize Interfaces. For example I don't get the search working for my custom fields.

The most helpful page I found is https://docs.typo3.org/p/lochmueller/calendarize/main/en-us/DeveloperManual/OwnEvents/Index.html But these are just some lines of code. I am rather not a Typo3 professional, but I can't imagine anyone can work with this little information.

So how do you guys work with Calendarize programming - do you look into the source code, is there any documentation I have not found or are there any sample Extentions around?

Many thanks, Geri

lochmueller commented 6 months ago

Hey @geri777 , yes, the documentation is very basic and only describe the general registration of a new event structure. If there are more complex integration scenarios, you could check the code or other extensions of the EXT:calendarize ecosystem: https://github.com/lochmueller/calendarize?tab=readme-ov-file#calendarize-infrastructure There are many events to manipulate the search output and also the query on the index. Example: https://github.com/lochmueller/calendarize_pages/blob/main/Classes/EventListener/IndexRepositorySearchListener.php

I suggest checking the code and the internal events (they are more or less not TYPO3 specific and regular PSR Events that are fired in the rendering/selection process). I close this issue... if there are problem with events, feel free to write in TYPO3 Slack or create new issues. Regards, Tim

geri777 commented 6 months ago

Thank you @lochmueller, the links you provided are helpful. Hopefully tutorials will follow sometimes ;-)