Categories and Tags renamed\nUpgrading from pre 1.0.7 requires you to rename taxonomies due to prefix requirements.<\/p>\n\n
`\n<\/code><\/pre>","events_categories => osec_events_categories":"UPDATE wp_term_taxonomy<\/code> SET taxonomy<\/code> = 'osec_events_categories' WHERE taxonomy<\/code> = 'events_categories';<\/p>","events_tags => osec_events_tags":"UPDATE wp_term_taxonomy<\/code> SET taxonomy<\/code> = 'osec_events_tags' WHERE taxonomy<\/code> = 'events_tags';\n `<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3482264,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3482264,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3482242,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3482264,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"open-source-event-calendar\/osec-calendar-classic":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"open-source-event-calendar\/osec-calendar-classic","version":"0.2.0","title":"Osec Calendar","category":"widgets","icon":"calendar-alt","description":"Osec classic Bootstrap block.","example":{},"supports":{"html":false,"multiple":false,"align":["full","wide"],"alignWide":true},"textdomain":"open-source-event-calendar","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style.scss","viewScript":"file:.\/view.js","attributes":{"view":{"type":"string","default":"agenda","enum":["month","week","oneday","agenda"]},"fixedDate":{"type":"string","default":null},"taxonomies":{"default":[],"type":"array"},"postIds":{"default":[],"type":"array"},"limit":{"default":10,"type":"integer"},"limitBy":{"type":"string","default":"events","enum":["events","days"]},"displayViewSwitch":{"default":true,"type":"boolean"},"displayDateNavigation":{"default":true,"type":"boolean"},"displayFilters":{"default":true,"type":"boolean"},"displaySubscribe":{"default":true,"type":"boolean"},"agendaToggle":{"default":false,"type":"boolean"}}}},"tagged_versions":["1.0.11","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3461927,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3461927,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3461927,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3461927,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3482242,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3482242,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3482242,"resolution":"7","location":"assets","locale":""},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3461927,"resolution":"8","location":"assets","locale":""},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3492493,"resolution":"9","location":"assets","locale":""}},"screenshots":{"1":"Month view","2":"Week view","3":"Agenda view","4":"Calendar Block UI","5":"Manage iCal Feeds","6":"Recurring Events","7":"Cache Settings","8":"Mobile Agenda View","9":"Schema.org\/Event data validator"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[416,1486,255917,6296],"plugin_category":[40],"plugin_contributors":[77795,84916,77982,255918,77986,234671,77983,77794],"plugin_business_model":[],"class_list":["post-236669","plugin","type-plugin","status-publish","hentry","plugin_tags-calendar","plugin_tags-events","plugin_tags-ical-importer","plugin_tags-ics","plugin_category-calendar-and-events","plugin_contributors-bangelov","plugin_contributors-digitaldonkey","plugin_contributors-hubrik","plugin_contributors-jbutkus","plugin_contributors-lpawlik","plugin_contributors-nicolapeluchetti","plugin_contributors-vtowel","plugin_contributors-yaniiliev","plugin_committers-digitaldonkey"],"banners":{"banner":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/banner-772x250.png?rev=3482264","banner_2x":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/banner-1544x500.png?rev=3482242","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/icon.svg?rev=3482264","icon":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/icon.svg?rev=3482264","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-1.png?rev=3461927","caption":"Month view"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-2.png?rev=3461927","caption":"Week view"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-3.png?rev=3461927","caption":"Agenda view"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-4.png?rev=3461927","caption":"Calendar Block UI"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-5.png?rev=3482242","caption":"Manage iCal Feeds"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-6.png?rev=3482242","caption":"Recurring Events"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-7.png?rev=3482242","caption":"Cache Settings"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-8.png?rev=3461927","caption":"Mobile Agenda View"},{"src":"https:\/\/ps.w.org\/open-source-event-calendar\/assets\/screenshot-9.png?rev=3492493","caption":"Schema.org\/Event data validator"}],"raw_content":"\nInstall as any other plugin, or from GitHub.<\/p>\n\n
Setup steps<\/strong><\/p>\n\n\n- Open the plugin settings page and save once<\/li>\n
- Configure:\n\n
\n- Timezone<\/li>\n
- UI date formats<\/li>\n
- Week start day<\/li>\n<\/ul><\/li>\n
- Review
WordPress \u2192 Settings \u2192 General<\/code> for output date formats.<\/li>\n- (Optional) Override constants file:\nCopy constants-local.php.example<\/a> and save as
constants-local.php<\/code><\/li>\n<\/ol>\n\nTo remove all plugin data on uninstall, set: define('OSEC_UNINSTALL_PLUGIN_DATA', true);<\/code><\/p>\n\n\n\n\"I really need feature XYZ\"<\/h3><\/dt>\nLet's draft it out on GitHub<\/a>. You could donnate\/pay me development time to get it contributed. Invoices possible. Or feel free to implement the requested feature yourself and create a Pull Request for it.\nI may also provide paid support.<\/p>\n\n<\/dd>\n\n<\/dl>\n\n\n1.1.0<\/h4>\n\n\n- OpenStreetMap support including Geocoding in Edit form.<\/li>\n
- Added full schema.org\/Event support for single Event page using plana theme. Check search engine readability<\/a>.<\/li>\n
- Reworked backend forms: Event edit, Themes, Theme options, Settings, Feeds.<\/li>\n
- Reworked PLANA theme fit better into current WP standard themes.<\/li>\n
- Removed outdated Google Maps support.<\/li>\n
- Reworked Readme.md to look better on github. Build tool to generate Readme.txt from Readme.md, CHANGELOG.md and constants.<\/li>\n
- Automated WordPress plugin directory deployment<\/li>\n
- Excerpt support: Enables to write Event summary and content separately.<\/li>\n
- Ability to enable\/disable features: Location, Excerpt, Maps, Coast, Comments, Shortcodes.<\/li>\n<\/ul>\n\n
1.0.11<\/h4>\n\n\n- Beautified Theme options admin page<\/li>\n
- Adjusted information text on settings page<\/li>\n
- Back button url is not stored in cookie die to missing div#id. Fixes #16<\/li>\n
- Fixing Can not selext Sunday in admin page settings fixes #14<\/li>\n
- Add legacy Uri support for Ical feeds. Maybe Fixes: #12<\/li>\n
- Cleanup Metaboxes, fix Metabox-Editing, remove unnecessary constants.<\/li>\n<\/ul>\n\n
1.0.10<\/h4>\n\n\n- Beautified Admin Theme admin page<\/li>\n
- Twigify Admin Theme theme-row.<\/li>\n
- Add more plugin-check fixes, escape shortcodes, <\/li>\n<\/ul>\n\n
1.0.7<\/h4>\n\n\n- Fix additional redirect happening due to trailing slash in Link<\/li>\n
- Fix custom font. Closes #8\nMore WP plugin check work.<\/li>\n
- Renaming capabilities with prefix<\/li>\n
- Rename Taxonomies: events_categories, events_tags, events_feeds to osec_events_categories, osec_events_...<\/li>\n
- Fix some default value issues, timezone default<\/li>\n
- clean up translations, nonces, prefixes <\/li>\n
- migrate php templates to twig<\/li>\n
- Rework\/fix: robots.txt generation, exact_date, get_exact_date, variable variants,<\/li>\n
- Updates: WP phpcs config, tools (npm) and composer updates<\/li>\n<\/ul>\n\n
1.0.4<\/h4>\n\n\n- Fix: Move content display out of OSEC block<\/li>\n
- Fix: subscribe display settings inverted.<\/li>\n
- Disallow direct file access<\/li>\n
- Renaming capabilities consistently<\/li>\n
- composer upgrade<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Allow all data attributes in Kses. Fixes persisten admin notices can not be dismissed.<\/li>\n
- fix overriding time\/date-separators using i18n<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Rework translation at German example (I love Loco Translate)<\/li>\n
- Fixed: Category image will now be used as default featured image in single event view.<\/li>\n
- Fixed: Function _load_textdomain_just_in_time was called incorrectly. <\/li>\n
- If toggle in Agenda view is disabled link to the single Event on title click.<\/li>\n
- Fixed: \"Click on title toggles when toggler is disabled.\"<\/li>\n
- Fixed: OSEC_PARSE_LESS_FILES_AT_EVERY_REQUEST does not work but lead to undefined variables.<\/li>\n
- Enabled disabling the Print icon in settings.<\/li>\n
- Improve (responsive) Linebreaks in date views with non-breaking spaces.<\/li>\n
- Simplified Plana theme to apply more WP global styles.<\/li>\n
- Update Twi-js tooling enables updating Twig-JS based templates for frontend-rendering<\/li>\n
- Simplify plana singe page template<\/li>\n
- Fix Category image upload UI and add option to use fallback image if no post featured image is set.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Add more integration tests<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Rework query params, fixed date pagers <\/li>\n
- Reworked date display to be consistent for Single and multiday and Allday Events.<\/li>\n
- Add flexible width Gutenberg Calendar Block<\/li>\n
- Removed Widget and Agenda Widget. <\/li>\n
- Reworked date display to be consistent.<\/li>\n<\/ul>\n\n
0.9.0<\/h4>\n\n\n- Added Sourcemaps for CSS (requires OSEC_DEBUG )<\/li>\n
- Documented hooks and actions (@see hooks-and-filters.md)<\/li>\n
- Added WP > 6 compatibility<\/li>\n
- Reworked plugin using PHP-Composer, Added PHP8 compatibility. Replaced Registry class loading with PHP use-statements<\/li>\n
- Removed tons of unused, service integration and legacy code.<\/li>\n
- Rewrote install\/Uninstall\/bootstrapping. You can purge all data on uninstallation by setting OSEC_UNINSTALL_PLUGIN_DATA to TRUE.<\/li>\n
- Cleand up unclear date formatter settings. Frontend Date formats are now defined\/changed in WordPress settings-general page.<\/li>\n
- Removed legacy theme support, merged chains of purposeless inherited classes, renamed many things hopefully improving code clarity and maintainability.<\/li>\n
- Fixed Week-view date selection.<\/li>\n
- Fixed\/rewrote caching system. Added APCU caching.<\/li>\n
- Added Test environment working well in ddev. Based on WP handbook standards plugin-unit-tests<\/a>.<\/li>\n
- Upgrade strings to match current translation requirements. <\/li>\n
- Solving WordPress \"Plugin Check\" minimum requirements.<\/li>\n<\/ul>\n\n\n
An event calendar with native iCal \/ ICS import and export<\/p>\n\n
Features<\/h3>\n\n
All features are provided in their entirety. No features are locked behind any add-ons<\/strong>.<\/p>\n\n\n- Full iCal \/ ICS import & export<\/strong>\n\n
\n- Automatically import external calendars<\/li>\n
- Categorize and tag imported feeds<\/li>\n<\/ul><\/li>\n
- Recurring events<\/strong>, including complex recurrence rules (RFC 5545)<\/a><\/li>\n
- Filtering by category and tag<\/li>\n
- Calendar sharing<\/strong> with Google Calendar, Apple iCal, Outlook, and any other system that accepts iCalendar (.ics) feeds<\/li>\n
- Month, week, day, and agenda views<\/li>\n
- Upcoming Events<\/strong> Gutenberg block<\/li>\n
- Direct links to filtered calendar views<\/strong><\/li>\n
- Color-coded events by category<\/li>\n
- Featured event images and category images<\/li>\n
- SEO-optimized event pages<\/li>\n
- Mobile-friendly and responsive layouts<\/li>\n
- Embedded OpenStreetMap<\/strong><\/li>\n
- Theme options to customize your calendar appearence<\/li>\n
- Your calendar can be embedded into a WordPress page without needing to create template files or modify the theme.<\/li>\n<\/ul>\n\n
Import events from other calendars<\/strong> and offer users the ability to subscribe to your calendar<\/strong>.<\/p>\n\nImporting and exporting iCalendar (.ics) feeds is one of the strongest features of the Event Calendar system. This allows you to manage your websites calendar by providing a public calendar from your Google, Apple or other calendar management software.<\/p>\n\n\n\n
Blocks<\/h3>\n\n
You can embed the calendar by adding a OSEC Calendar Block<\/strong> to any page or post. Alternatively there is a shortcode available.<\/p>\n\n\n [!WARNING] \n At this time, only one calendar per page or post<\/strong> is supported.<\/p>\n<\/blockquote>\n\nOn the long run it's planned to have a Rest API to allow the calendar being rendered with more modern frontend tools than the current, outdated, but nice old Bootstrap 3 stuff.<\/p>\n\n
Shortcodes<\/h3>\n\nCalendar Views<\/h4>\n\n[osec] \/\/ Default view per settings\n[osec view=\"monthly\"]\n[osec view=\"weekly\"]\n[osec view=\"agenda\"]\n[osec view=\"daily\"]\n<\/code><\/pre>\n\nFiltering<\/h4>\n\n
By category<\/strong><\/p>\n\n[osec cat_name=\"Holidays\"]\n[osec cat_name=\"Lunar Cycles,zodia-date-ranges\"]\n[osec cat_id=\"1\"]\n[osec cat_id=\"1,2\"]\n<\/code><\/pre>\n\nBy tag<\/strong><\/p>\n\n[osec tag_name=\"tips-and-tricks\"]\n[osec tag_name=\"creative writing,performing arts\"]\n[osec tag_id=\"1\"]\n[osec tag_id=\"1,2\"]\n<\/code><\/pre>\n\nBy post ID<\/strong><\/p>\n\n[osec post_id=\"1\"]\n[osec post_id=\"1,2\"]\n<\/code><\/pre>\n\n\n\nRequirements<\/h3>\n\n\n- WordPress: 6.6 or newer<\/li>\n
- PHP:\n\n
\n- PHP 8.2+ required for development<\/li>\n
- PHP 8.1 may work for production builds when installed with
composer install --no-dev<\/code><\/li>\n<\/ul><\/li>\n<\/ul>\n\nLanguages<\/h3>\n\n
OSEC supports multiple languages<\/p>\n\n
This Is a Fork<\/h3>\n\n
OSEC is a fork of the GPL licensed plugin All-in-one-Event-Calendar by Timely. At it's time a great plugin with a solid but unmaintainable codebase (not all required developer tools where opensourced).<\/p>\n\n
If you love truly open source software and don't mind to get your hands dirty you should join here. Free people need free software to manage and share events in a selfhosted manner.<\/p>\n\n
External services<\/h3>\n\n
OSEC may connect to OpenStreetMap to render maps. If you using maps feature make sure you agree with Terms of Service<\/a><\/p>\n\nOSEC may connect to OpenStreetMap Nominatim geocoding API. Terms of Service<\/a>.\nYou may need to switch the servive on a heavy traffic site as Nominatim allows an absolute maximum of 1 request per second<\/em>.<\/p>\n\nBy default leaflet and leaflet-control-geocoder are loaded from unpkg.com. Terms of Service<\/a>.<\/p>\n\nYou can change using hooks: osec_leaflet_library_alter<\/code>, osec_leaflet_geocoder_library_alter<\/code>.<\/p>\n\nMigration Notes<\/h3>\n\n
Database structure is not fully compatible with All-in-One Event Calendar v2.3.4<\/p>\n\n
Migration may be possible with manual effort<\/p>\n\n
A standardized upgrade path may be developed if there is demand and contributions<\/p>\n\n
See this wiki<\/a> for currently known information on migrating.<\/p>\n\n\n\nDevelopment & Support<\/h3>\n\n
The principle behind this plugin is to be Open Source. Get in touch on GitHub<\/a> to report issues, propose feature enhancements, and get general guidance for contributing.<\/p>\n\nWriting this fork was a huge effort<\/a>.<\/p>\n\nDigitaldonkey believes everybody should be able to set up and manage public calendars.<\/p>\n\n
If you are implementing this plugin for others you should support ongoing development with a donation<\/a> or contribution<\/a>.<\/p>\n\n