Title: WP Request Callback
Author: kiteframe
Published: <strong>September 30, 2019</strong>
Last modified: September 30, 2019

---

Search plugins

![](https://ps.w.org/wp-request-callback/assets/banner-772x250.png?rev=2165824)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/wp-request-callback/assets/icon.svg?rev=2165824)

# WP Request Callback

 By [kiteframe](https://profiles.wordpress.org/kiteframe/)

[Download](https://downloads.wordpress.org/plugin/wp-request-callback.0.1.0.zip)

 * [Details](https://twd.wordpress.org/plugins/wp-request-callback/#description)
 * [Reviews](https://twd.wordpress.org/plugins/wp-request-callback/#reviews)
 *  [Installation](https://twd.wordpress.org/plugins/wp-request-callback/#installation)
 * [Development](https://twd.wordpress.org/plugins/wp-request-callback/#developers)

 [Support](https://wordpress.org/support/plugin/wp-request-callback/)

## Description

Easily add a form to any page on your site to allow visitors to leave their name
and number to request a callback.

### Settings

The settings page can be reached by clicking on Settings in the WordPress admin 
menu, and then clicking on WP Request Callback.

Here you can add an email address to receive email notifications, as well as a Slack
Webhook URL to enable notifications straight into a Slack channel.

Also on this page you can choose the default theme color. This will be used by the
shortcode as the background color of the submit button and the border color of the
focussed inputs.

The color can be overridden on a per form basis by using the shortcode settings 
as documented below.

### Configuring the Shortcode

The shortcode usage is as follows: `[wprc success_message="This is my custom success
message." error_message="Something went wrong." color="#9f7aea"]`

 * success_message is the text displayed to the user after the form is submitted
   successfully. It is optional and if omitted the default message is ‘Thanks for
   submitting your callback request.’
 * error_message is the text displayed to the user if an unexpected error occurs
   with the submission. It is optional and if omitted the default message is ‘Something
   went wrong. Please try again.’
 * color is a hex color code that is used to style the button and inputs of the 
   form. It is optional, and if omitted, the color set on the settings page is used,
   or blue by default (#9f7aea).

### API Documentation

The plugin makes use of the WordPress [REST API](https://developer.wordpress.org/rest-api/).

#### Endpoint

POST /wp-json/wprc/v1/callback-requests

#### Request Body

name: Required, string.
 phone: Required, string, numbers or spaces.

Example:
 { name: ‘Name’, phone: ‘01234567890’ }

#### Responses

_Success_
 Status: 201 Response data: ‘Success’

_Validation error_
 Status: 422 Response data: { errors: { name: [‘Example validation
error’], phone: [‘Example validation error’] } }

## Screenshots

 * [[
 * The settings screen.
 * [[
 * The built in form.
 * [[
 * The built in form as part of the WordPress Twenty Nineteen theme.
 * [[
 * Adding the shortcode to a page.
 * [[
 * A success message after submission.
 * [[
 * Customising the theme colour.
 * [[
 * Email notifications.
 * [[
 * Slack notifications.
 * [[
 * List of callback requests in the admin screen.

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/wp-request-callback` directory,
    or install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. Use the Settings->WP Request Callback screen to add an email address and/or Slack
    Webhook URL to enable notifications.
 4. Add a built in form to your page using our shortcode, or if you’re feeling adventurous,
    write your own using the API. See instructions for both below.

## FAQ

  Help – something went wrong!

If you’re having any problems at all with this plugin, don’t hesitate to get in 
touch on the support forum and we’ll respond as soon as we can.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WP Request Callback” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ kiteframe ](https://profiles.wordpress.org/kiteframe/)

[Translate “WP Request Callback” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-request-callback)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-request-callback/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-request-callback/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-request-callback/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-request-callback/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.0

 * First release!

## Meta

 *  Version **0.1.0**
 *  Last updated **7 years ago**
 *  Active installations **10+**
 *  WordPress version ** 5.0 or higher **
 *  Tested up to **5.2.24**
 *  PHP version ** 7.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-request-callback/)
 * Tags
 * [callback](https://twd.wordpress.org/plugins/tags/callback/)[callback request](https://twd.wordpress.org/plugins/tags/callback-request/)
   [phone](https://twd.wordpress.org/plugins/tags/phone/)[request](https://twd.wordpress.org/plugins/tags/request/)
 *  [Advanced View](https://twd.wordpress.org/plugins/wp-request-callback/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/wp-request-callback/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-request-callback/reviews/)

## Contributors

 *   [ kiteframe ](https://profiles.wordpress.org/kiteframe/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-request-callback/)