Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trevanhetzel/smooth-calendar
A simple and flexible WordPress calendar plugin
https://github.com/trevanhetzel/smooth-calendar
Last synced: about 1 month ago
JSON representation
A simple and flexible WordPress calendar plugin
- Host: GitHub
- URL: https://github.com/trevanhetzel/smooth-calendar
- Owner: trevanhetzel
- License: gpl-2.0
- Created: 2015-08-07T04:06:45.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-02-19T03:45:38.000Z (over 8 years ago)
- Last Synced: 2024-04-16T22:27:32.466Z (7 months ago)
- Language: PHP
- Size: 404 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Smooth Calendar
==========
### A simple and flexible WordPress calendar plugin
Smooth Calendar is a straightfowrward solution to displaying events on a WordPress site. First and foremost, the calendar view allows users of your site to quickly see events for a given month. Multiple events can be displayed on a single day and there is an option to display a single page for each event, perfect for linking people to an event page from social media!
The plugin uses JavaScript to fetch data, which provides for a fast and easy to use experience for users. The experience in the Dashboard is also very user friendly, as each event is a custom post type with easy to understand fields.
While the plugin can certainly be installed and used right out of the box, there is much room for flexibility and extending the plugin. From styling it to fit your site's theme to adding even more functionality, this plugin was written in an extendable way to fit you as a site owner's or developer's needs.
A lot of time has been spent to make this calendar plugin as user friendly on as many devices as possible. It's fully responsive and works on every modern device it's viewed on. Phone, tablet, laptop or desktop, the user experience is just the same!
There is an abundance of WordPress calendar plugins, but if you're looking for a responsive, easy to get going (and easy for clients to manage) calendar plugin, Smooth calendar is your best bet!
### Features
- Responsive
- Supports multiple events on a single day
- "Quick view" of event
- Ability to have single pages for each event (which makes it SEO friendly)
- Customizable colors
- Easily extendable
- Uses custom post types and metadata, which makes creating your own theme very straightforward
- Allows the display of an event title, date, start/end time, location and description
- Google Calendar integration
### Installation
1. Upload [`smooth-calendar`](https://github.com/trevanhetzel/smooth-calendar/archive/master.zip) to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Place the calendar in a page using the shortcode `[smooth-calendar`] (optionally place it in a theme file with ``)
4. Update the settings by viewing the Settings page under the 'Calendar' tab. If you'd like each event to have its own page, check the 'Enable single pages' checkbox.
### FAQ
**How can I modify the "single" template**
The single event template can be overridden by adding a file in your theme called `single-calendar.php`.
**Can I have multiple calendars?**
No. Currently, only one calendar is supported. You could technically display multiple calendars by using categories or tags though.
**How can I display upcoming events elsewhere on my site?**
You can write a loop, querying the `calendar` post type and ordered by the `meta_calendar_data` meta value. Something like this:
```
array('calendar'),
'showposts' => 3,
'meta_key' => 'meta_calendar_date',
'meta_value' => date('Y-m-d'),
'meta_compare' => '>=',
'orderby' => 'meta_value',
'order' => 'ASC'
);
$events_posts = get_posts($events_args);
echo '
- ';
-
meta_calendar_date)); ?>
meta_calendar_date))); ?>
meta_calendar_location; ?>
foreach ($events_posts as $post) {
setup_postdata( $post ); ?>
```
### Screenshots
