Gravity Wiz

Magically enhanced tutorials, snippets and plugins for Gravity Forms!

Schedule a Post by Date Field with Gravity Forms

Schedule your Gravity Forms generated posts to be published at a future date. The scheduled date can be specified manually in the code or by the submitting user via Gravity Form Date and Time fields.

Last updated | Written by 36 Comments

  • March 8th, 2016: Updated snippet to only set future publish date if date field has a value.

With Gravity Forms, allowing users to submit posts to your WordPress website couldn’t be easier. Currently, you can set the default status of the generated WordPress post as “Draft”, “Pending” or “Published”.

This snippet provides the ability to schedule the post to be published at a future date. It can be configured to publish on a user-defined date/time (via submitted form data), a static date/time, or a combination of the two.

Show CodeDownload Code
<?php
/**
* Gravity Wiz // Gravity Forms // Schedule a Post by Date Field
*
* Schedule your Gravity Form generated posts to be published at a future date, specified by the user via GF Date and Time fields.
*
* @version 1.0
* @author David Smith <david@gravitywiz.com>
* @license GPL-2.0+
* @link https://gravitywiz.com/...
*/
// CHANGE: "546" to the ID of your form
add_filter( 'gform_post_data_546', 'gw_schedule_post_by_date_field', 10, 3 );
function gw_schedule_post_by_date_field( $post_data, $form, $entry ) {
$date = $entry['7']; // CHANGE: "7" to the ID of your Date field
$time = $entry['8']; // CHANGE: "8" to the ID of your Time field
### don't touch the magic below this line ###
if( empty( $date ) ) {
return $post_data;
}
if( $time ) {
list( $hour, $min, $am_pm ) = array_pad( preg_split( '/[: ]/', $time ), 3, false );
if( strtolower( $am_pm ) == 'pm' ) {
$hour += 12;
}
} else {
$hour = $min = '00';
}
$schedule_date = date( 'Y-m-d H:i:s', strtotime( sprintf( '%s %s:%s:00', $date, $hour, $min ) ) );
$post_data['post_status'] = 'future';
$post_data['post_date'] = $schedule_date;
$post_data['post_date_gmt'] = get_gmt_from_date( $schedule_date );
$post_data['edit_date'] = true;
return $post_data;
}
view raw gw-gravity-forms-schedule-post-by-date-field.php hosted with ❤ by GitHub

Getting Started

  1. Check requirements

  2. Install the snippet

    • Copy and paste the entire snippet into your theme’s functions.php file.

  3. Configure the snippet

    • Change the form ID and the $date and $time variables to match your date and time field.

Configuration Options

Not sure how to change the variables? Follow the step-by-step instructions below.

Setting the Form ID

add_filter( 'gform_post_data_546', 'gw_schedule_post_by_date_field', 10, 3 );

Update 546 to the ID of your form. This will ensure that only the posts created by the form you specify are scheduled for the future.

Setting the Field IDs

$date = $entry['7']; // CHANGE: "7" to the ID of your Date field
$time = $entry['8']; // CHANGE: "8" to the ID of your Time field

Update the 7 on the first line to the ID of your Date field and the 8 on second line to your Time field. This is how the code knows which Date and Time field to use to set the scheduled publish date.

Bonus: Static Time, User-specified Date

$date = $entry['7']; // CHANGE: "7" to the ID of your Date field
$time = '09:00 am'

With this option, the user selects which date the post should be published on; however, you (the admin) would set a static time for it to be published. This is useful when you don’t want to overburden the user with options.

Make sure to include a leading zero if you’re setting a single digit hour and a space between the numbers and the am/pm. The 24-hour time format is also supported.

Bad:2:30pm
Good:02:30 pm
Good:14:30

FAQ

How do I apply this to multiple forms?

I wrote an alternate version that allows you to configure this for multiple forms. You can view it here.

Was this helpful?

If you’ve found this snippet helpful or have an idea to improve it, let us know in the comments!

Did this resource help you do something awesome with Gravity Forms? Then you'll absolutely love Gravity Perks; a suite of 29+ essential add-ons for Gravity Forms with support you can count on.

Comments

  2. Hi David,

    Is there a way to set a duration for the post. So, not only a start date, also an end date?

    Thanks Aldo

    Reply

    • A late reply, could help someone else… Yes, there is, and I am and not using the Post-Expirator plugin since it does not let you set the expiration time via custom/meta field by default. What I did was add a Start Time field (actually a Custom Field and selected Time as the type of input) in the form which saves to a custom/meta field, which is just simple text line with a time format to match your needs. Then I also added another time field this one to schedule/expire the post. Make sure to use 24 hour format for this, as I explained in an earlier comment.

  5. For those afraid to let their users submit / create posts scheduled to publish at a certain date or time, whether they’ve been reviewed or not, change line 37 in the above sample: $post_data[‘post_status’] = ‘future’; changing future to draft makes the post stay as a draft, whether the date / time passes or not: $post_data[‘post_status’] = ‘draft’;

    That way you can still have an admin review the content and hit “schedule”.

    Reply

  6. Hi David,

    Like Ricardo (above) I have a number of forms that I would like to schedule but the link to the pastie that you provided is empty. Can you let me have the snippet please.

    Many thanks, Alan

    Reply

  7. Hi David,

    Thanks for your help, I have the wrong field ID’s inserted. All working perfectly now. I have lots of forms and am interested in but your pastie link for multiple forms (above) is empty. Could you repost that code please.

    Many thanks, Alan

    Reply

  8. Hello David,

    Thanks for all your great work – Super helpful site.

    I have added the snippet and have the schedule calendar on the form but when I fill it in and post it gets published anyway.

    Am I missing something regarding the publish settings in the post title? I thought this snippet would override that.

    The site isn’t live but I could give you access

    Thanks in advance, Alan

    Reply

  10. Hi David, I have a little problem with the code for two forms in the same page. When I schedule a post with image in next month the image not appear. Have you any idea? Thanks. Riccardo

    Reply

  12. Hi David, thanks for this code, work perfectly with only one form! I have two forms (with two ID). It’s possible to scheduling the posts created with two different forms with the same code?

    Thanks a lot Riccardo

    Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.