Package Data | |
---|---|
Maintainer Username: | langemike |
Maintainer Contact: | mikevv@gmail.com (Mike van Veenhuijzen) |
Package Create Date: | 2016-06-09 |
Package Last Update: | 2018-02-19 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-09-01 03:00:25 |
Package Statistics | |
---|---|
Total Downloads: | 565 |
Monthly Downloads: | 123 |
Daily Downloads: | 1 |
Total Stars: | 5 |
Total Watchers: | 2 |
Total Forks: | 1 |
Total Open Issues: | 0 |
PHP Store Hours is a simple PHP class that outputs content based on time-of-day and-day-of-week. Simply include the script in any PHP page, adjust opening and closing hours for each day of the week and the script will output content based on the time ranges you specify.
// REQUIRED
// Define daily open hours
// Must be in 24-hour format, separated by dash
// If closed for the day, leave blank (ex. sunday) or don't add line
// If open multiple times in one day, enter time ranges separated by a comma
$hours = array(
'mon' => array('11:00-20:30'),
'tue' => array('11:00-13:00', '18:00-20:30'),
'wed' => array('11:00-20:30'),
'thu' => array('11:00-1:30'), // Open late
'fri' => array('11:00-20:30'),
'sat' => array('11:00-20:00'),
'sun' => array() // Closed all day
);
// OPTIONAL
// Add exceptions (great for holidays etc.)
// MUST be in format month/day[/year] or year-month-day
// Do not include the year if the exception repeats annually
$exceptions = array(
'2/24' => array('11:00-18:00'),
'10/18' => array('11:00-16:00', '18:00-20:30')
);
Choose what you'd like to output if you're currently open, currently closed, or closed all day. Shortcodes add dynamic times to your open or closed message.
// OPTIONAL
// Place HTML for output below. This is what will show in the browser.
// Use {%hours%} shortcode to add dynamic times to your open or closed message.
$template = array(
'open' => "<h3>Yes, we're open! Today's hours are {%hours%}.</h3>",
'closed' => "<h3>Sorry, we're closed. Today's hours are {%hours%}.</h3>",
'closed_all_day' => "<h3>Sorry, we're closed today.</h3>",
'separator' => " - ",
'join' => " and ",
'format' => "g:ia", // options listed here: http://php.net/manual/en/function.date.php
'hours' => "{%open%}{%separator%}{%closed%}"
);
This is the default method that outputs the templated content. You'll most likely want to use this.
$store_hours = new StoreHours($hours, $exceptions, $template);
$store_hours->render();
This returns an array with a full list of open hours (for a week without exceptions). Days with same hours will be grouped.
$store_hours = new StoreHours($hours, $exceptions, $template);
echo '<table>';
foreach ($store_hours->hours_overview() as $days => $hours) {
echo '<tr>';
echo '<td>' . $days . '</td>';
echo '<td>' . $hours . '</td>';
echo '</tr>';
}
echo '</table>';
This returns an array of the current day's hours.
$store_hours = new StoreHours($hours, $exceptions, $template);
$store_hours->hours_today();
This returns true/false depending on if the store is currently open.
$store_hours = new StoreHours($hours, $exceptions, $template);
$store_hours->is_open();
If you'd like to show multiple sets of hours on the same page, simply invoke two separate instances of StoreHours
. Remember to set the timezone before each new instance.
// New York Hours
date_default_timezone_set('America/New_York');
$nyc_store_hours = new StoreHours($nyc_hours, $nyc_exceptions, $nyc_template);
$nyc_store_hours->render();
// Los Angeles Hours
date_default_timezone_set('America/Los_Angeles');
$la_store_hours = new StoreHours($la_hours, $la_exceptions, $la_template);
$la_store_hours->render();
$ phpunit
If you're getting errors or if times are not rendering as expected, please double check these items before filing an issue on GitHub:
Please report any bugs or issues here on GitHub. I'd love to hear your ideas for improving this script or see how you've used it in your latest project.
Goes to Cory Etzkorn for developing php-store-hours