Ajebang Form and Survey Builder

[aj_form id="123"]

[aj_form id="123" title="0" image="0" description="0" deadline="0" links="0"]

[aj_form id="123" title_tag="h1"]

[aj_form id="123" sno="2"]

[aj_form_list]

[aj_form_list] accepts `type="survey|form|all"`, `ids="3,5"`, `limit="10"`,
orderby="date|title|deadline", `order="desc|asc"`, `excerpt="1"`, `words="25"`,
count="1", `deadline="1"`, `status="1"` and `image="1"`.

Changelog

1.9.1

• The virtual post cached for a shortcut page is now removed from the post cache
  when the request ends, so nothing the plugin writes outlives the request on
  sites running a persistent object cache.

1.9.0

• Renamed the plugin to “Ajebang Form and Survey Builder”. The former name combined
  a two-letter initialism with a generic term and was not distinctive enough for the
  plugin directory. The text domain, the plugin folder and the main file follow the
  new slug, ajebang-form-survey-builder.
• The form builder’s initial data is attached with wp_add_inline_script() instead
  of a <script> tag written into the page.
• The the_title filter callback escapes the title it returns. A filter callback’s
  return value is output by WordPress without any escaping of its own.
• Dropped load_plugin_textdomain() and the bundled .po/.mo files. Translations
  for a plugin hosted on wordpress.org come from translate.wordpress.org through the
  standard update system, so neither is needed.

1.8.8

• Removed the Plugin URI header. It pointed at the same address as Author URI,
  which wordpress.org rejects on upload — the two describe different things and
  neither is required. Author URI is the accurate one here; wordpress.org
  provides the plugin’s own page.

1.8.7

• The current URL is now derived from a sanitised REQUEST_URI. It is passed
  through esc_url_raw() rather than sanitize_text_field(), which strips %xx
  sequences and would mangle any address containing non-ASCII characters.
• Documented the deliberate deviations that Plugin Check reports, as phpcs:ignore
  comments with their reasons: anonymous submissions do not carry a nonce, input is
  sanitised after decoding rather than before, and the custom tables are reached
  with direct $wpdb calls. No change in behaviour — 100 warnings down to 1.

1.8.6

• Fixed choice display counts not saving. On any form where a count had never been
  set, the builder was not sending the changed values at all, so the screen said
  “Form saved” while the numbers stayed the same. The empty count list arrived as a
  JSON array rather than an object, and the values keyed by choice name were dropped
  during serialisation. Existing forms work from this version on, with no migration.
• Plugin Check fixes: the number in the “N responses deleted” notice is now escaped
  at the point of output, and a translators: comment was moved onto the line
  directly above its gettext call. No change in behaviour.
• The readme and the plugin header description are now in English.

1.8.5

• Reversed the display defaults for sno. [aj_form id="1" sno="1"] now renders the
  question on its own, without the title, featured image, description, deadline
  notice or related links. The attribute exists to drop a question into the middle of
  an article, where repeating all of that was in the way. A whole form, with no sno,
  still shows everything as before.
• Added the deadline attribute, which turns the “you can respond until…” notice on
  and off. The notice on a closed form always appears, since it explains why there is
  no form to fill in.
• Writing an attribute yourself beats either default, for example
  [aj_form id=”1″ sno=”1″ deadline=”1″].

1.8.4

• Added a Shortcodes tab to the settings screen. It lists every attribute of both
  shortcodes with its values, default and description, adds examples for common
  situations, and notes which options belong to the form rather than the shortcode.
  At the bottom it lists the forms on your site with copy ready shortcodes and links.

1.8.3

• The standalone page now hands its featured image to the theme, supplying it as the
  WordPress featured image, so the theme draws its usual header banner instead of
  leaving the image stranded below the content.
• Settings → General → standalone page → featured image is now a choice of three:
  leave it to the theme (default), print it in the content, or hide it. Values saved
  in 1.8.2 carry over to the first and third options respectively.

1.8.2

• Fixed the empty title area on standalone pages. Themes render an

<

h1 class=”entry-title”> slot, which stayed blank because the post is virtual.
The plugin now fills that slot through the the_title filter, leaving other titles
on the page, such as navigation items, untouched.
* Printing the title inside the content is now off by default, since the fix above
fills the theme’s own title area and leaving both on shows the title twice. The
option remains under Settings → General for themes with no title area at all.
* Added a setting for whether the standalone page shows the featured image. Listings
keep using it as a thumbnail either way.

1.8.1

• Fixed the missing form title on standalone pages. The shortcode suppressed the
  title on the assumption that the theme would draw it, which left a page with no
  title on themes that do not. The title is now printed as an h1 by default and can
  be turned off under Settings → General.
• Added featured images. Pick one from the media library per form and it appears
  above the form and as the thumbnail in listings. Turn it off with image="0".
• Question titles are now <h3> elements rather than labels, which were not headings
  as far as document structure was concerned. The hierarchy runs form title (h2, or
  h1 on a standalone page) then question title (h3), and result cards match. The
  wrapper changed from <p> to <div>, because a paragraph cannot contain a heading
  and browsers break the markup apart.
• Fixed choice labels rendering in bold. A font-weight rule meant for field titles
  was catching them too.
• Accessibility: single inputs are tied to their control with label for, and radio
  and checkbox groups are tied to their question title with role="group" and
  aria-labelledby.

1.8.0

• Added the [aj_form_list] shortcode, which shows published surveys as cards with
  the title, an excerpt, the response count, the deadline and an open or closed badge.
  Open surveys sort above closed ones and each card links to its standalone page.
• Added display attributes title, description and links to [aj_form]. All
  default to on. Titles are printed by default from this version, so add title="0"
  if your post already has one.
• Added the sno attribute for rendering a single question. Validation, submission
  and results are scoped to that question; everything else behaves as before.
• Added related links, a per-form list shown underneath the form.
• Added a response deadline. Forms run indefinitely by default. After the deadline the
  server refuses submissions and shows a notice, and surveys can go on showing their
  results.
• Added drafts. A draft form renders nothing, stays out of listings, and returns 404
  on its standalone link; administrators see it with a notice. New forms start as
  drafts. Existing forms all stay published.
• Added standalone links. Every form has its own page at /aj-form/{type}/{id}/. The
  base is configurable, and sites using plain permalinks fall back to
  ?aj_form_view=12.
• Added a Korean translation.
• No database schema change. The new options all live in the existing settings column.

1.7.4

• Fixed the mangled plugin description in the plugins list, caused by the Korean text
  in the plugin file and readme having been saved in the wrong encoding.
• Removed a UTF-8 byte order mark from the head of the plugin file. Those three bytes
  were sent before any header, which could make setcookie() and wp_safe_redirect()
  fail with “headers already sent”.

1.7.3

• Fixed “This form has expired. Please reload the page and try again.” blocking every
  submission. The nonce baked into a cached page expires after 24 hours while the page
  cache lives longer, so all visitors were posting a dead nonce. Logged out visitors
  are no longer asked for one, since without a session it carries no CSRF protection
  anyway, and the nonce for logged in users is refreshed as the page loads.

1.7.2

• Fixed nobody being able to take part on a cached page. Once a participant’s screen
  was cached, every later visitor received the results view with no form. The state
  correction now works in both directions and can bring the form back.

1.7.1

• Dark theme support. Hard-coded light colours on the front end — bar backgrounds,
  inputs, choice boxes, notices — were replaced with neutral values that follow the
  theme, fixing bar backgrounds that glowed white on dark themes.

1.7.0

• Page cache support. A full page cache could serve the “not yet answered” screen and
  allow a repeat response. The plugin now fetches the real state after the page loads,
  corrects the screen, and refreshes an expired nonce at the same time.
• Repeat limiting by IP is stronger: a previous response is found by IP even when the
  cookie is gone.
• Added an option for showing the response count per question.
• Added survey defaults to the global settings, so new forms start with the options
  you prefer.
• Split the settings and form edit screens into tabs.

1.6.0

• Improved the survey results layout. Each question is a card with its response count
  beside the title, which fixes the missing boundaries between questions.
• Added an option for showing the total response count.
• Added per-question submission. Answering one question turns that question into its
  result immediately and leaves the rest alone.
• Added deleting all responses, from the form list and the responses screen. The form
  definition is kept.
• Added the global settings screen at Ajebang Forms → Settings.
• Added adjustable display counts per choice. Turn it on in the global settings and
  the builder lets you set the number shown for each option. Turn it off and stored
  values are ignored, leaving the real response counts.

1.5.0

• Added repeat-response limiting, per form: none, browser cookie, or cookie and IP.
  The default is cookie. A visitor who has already taken part sees the results.
• Added an option to hide the submit button and send the form automatically once every
  field is filled. Visitors without JavaScript still see the button.
• Added internationalisation: a Domain Path header, load_plugin_textdomain() and a
  bundled POT file. Translations were not being loaded before this.
• Improved string extraction with more translators: comments and _n() for counts.

1.4.0

• Added a per-form option for whether a thank-you message appears after submission.
  With it off, the results appear straight away.
• Added the settings column used to store per-form options. Existing rows fall back to
  the default of showing the message.

1.3.2

• Tidied the plugin header: added Requires at least, Requires PHP and the licence
  fields, and updated Tested up to.

1.3.1

• Improved the survey results layout by putting each choice label on its own line with
  the bar and figures below it, which fixes long labels overlapping in narrow columns.
• Removed the fixed width from the results screen.

1.3.0

• Added AJAX submission on the front end. The page is not left behind, and surveys turn
  into their results in place. Browsers without JavaScript fall back to a normal post.
• Fixed submissions redirecting to the home page. A form posting to itself made the
  redirect target impossible to work out.
• Added server-side validation of required fields, including checkbox groups.
• Added Preview to the admin form list, matching the front end with submission disabled.

1.2.1

• Fixed a permission error when administrators opened View Statistics or
  View Submissions.

1.2.0

• Added a description field, shown above the form controls.
• Added collapsing and expanding of individual fields in the builder.
• Improved radio and checkbox styling on the front end.

1.1.0

• Added form types. Surveys show aggregated statistics.

1.0.0

• First release.