Skip to content

Latest commit

 

History

History
executable file
·
112 lines (70 loc) · 3.72 KB

README.md

File metadata and controls

executable file
·
112 lines (70 loc) · 3.72 KB
Raw

Build Status Code Climate

ACF Date and Time Picker Field

Adds a 'Date and Time Picker' field type for the Advanced Custom Fields WordPress plugin.

ACF PRO 5.+ is no longer supported, ACF PRO has its own date and time picker

Overview

This is an add-on for the Advanced Custom Fields WordPress plugin, that allows you to add a Date and Time Picker field type.

Compatibility

This add-on will work with ACF 3 and 4

Installation

This add-on can be treated as both a WP plugin and a theme include. The plugin is also available from the WordPress plugin directory

Install as Plugin

  1. Copy the 'acf-date_time_picker' folder into your plugins folder
  2. Activate the plugin via the Plugins admin page

Include within theme

  1. Copy the 'acf-date_time_picker' folder into your theme folder (can use sub folders). You can place the folder anywhere inside the 'wp-content' directory
  2. Edit your functions.php file and add the code below (Make sure the path is correct to include the acf-date_time_picker.php file)
add_action('acf/register_fields', 'my_register_fields');

function my_register_fields()
{
	include_once('acf-date_time_picker/acf-date_time_picker.php');
}

Frequently Asked Questions

Updating to ACF PRO

I got this quetion over at AWP on Facebook:

How does upgrading work? If someone starts with ACF and your plugin, then upgrades to ACF Pro, will their date/time custom field disappear? I understand the data will be maintained but wondering if the field will still be visible in WP admin.

Updating to ACF PRO should work fine, ACF PRO has a compatibility add-on for this plugin, but test it on a non production environment first.

Also, read the comments on this issue: https://github.com/.../acf-field-date-time-picker/issues/103

How do I set the date and time format?

To set the date and time format when you create the field, you have to create a string using the letters below.

Date format

	d    day of month (no leading zero)
	dd   day of month (two digit)
	o    day of the year (no leading zeros)
	oo   day of the year (three digit)
	D    day name short
	DD   day name long
	m    month of year (no leading zero)
	mm   month of year (two digit)
	M    month name short
	MM   month name long
	y    year (two digit)
	yy   year (four digit)

Time format

	H    Hour with no leading 0 (24 hour)
	HH   Hour with leading 0 (24 hour)
	h    Hour with no leading 0 (12 hour)
	hh   Hour with leading 0 (12 hour)
	m    Minute with no leading 0
	mm   Minute with leading 0
	s    Second with no leading 0
	ss   Second with leading 0
	l    Milliseconds always with leading 0
	t    a or p for AM/PM
	T    A or P for AM/PM
	tt   am or pm for AM/PM
	TT   AM or PM for AM/PM

Examples

  • yy-mm-dd: 2013-04-12
  • HH:mm: 24 hour clock, with a leading 0 for hour and minute
  • h:m tt: 12 hour clock with am/pm, no leading 0

More Information

http://soderlind.no/time-picker-field-for-advanced-custom-fields/

Changelog

Please see Changelog.md