search

coralproject / ask-wp-plugin

A WordPress plugin for Ask
11 stars 7 forks source link

readme

Ask WordPress Plugin

About Ask

Ask is a form tool, built specifically for journalists. Read about it here.

Ask lets you easily create embeddable forms, manage submissions, and display galleries of the best responses. It’s fast, flexible, and you control the design and the data.

You can find out how to install and manage Ask here: https://docs.coralproject.net/products/ask/

Ask is an open source product brought to you by The Coral Project. Find out more about Coral and the tools we build here: https://coralproject.net

Installing the Ask WordPress Plugin

Ask integrates seamless with WordPress.

First, you have to install Ask on a server, so that the admin and user data can be stored. For install information see https://docs.coralproject.net/products/ask/, and email jeff@mozillafoundation.org if you have any questions.

When you have Ask installed, follow these instructions:

  1. Download the ask-wp-plugin as a zip file by clicking 'Clone or Download' in the top right on this page, then 'Download Zip'

    download download2

  2. Install and activate the plugin on your WordPress site. Go here to learn how to do that.

  3. Click the 'Ask Forms' button on your WordPress menu.

    askmenubutton

  4. Create a form within Ask (instructions here) then click Publish Options

  5. Copy and paste the start of the standalone URL before the long form ID number, and paste it into the Server Base URL

    urlsetting screen shot 2017-01-19 at 12 20 36 pm

  6. If you'd like to use Ask entirely inside WordPress, paste the URL of your Ask install into the Admin Base URL field (not required)

    screen shot 2017-01-19 at 12 29 34 pm

    This will create a second menu item in your WordPress Ask Forms Menu.

    screen shot 2017-01-19 at 12 30 18 pm

    Now you have Ask installed successfully in WordPress!

Publishing an Ask Form in WordPress

  1. Create an Ask form (instructions here), click on Publish Options, and click on WordPress shortcode wordpress1

  2. Copy the shortcode and paste it into your WordPress post/page wherever you would like the form to appear. wordpress2

You can publish the form anywhere else, using iframe, script tag or standalone options, and responses will go into the same submission manager.

The same option is available for the Gallery. wordpress3