Knowledge Base / NKS: Contact Form

Generated by Daux.io

Getting Started

Thursday, June 16, 2016 12:54 AM

Ninja Kick: Contact Form is a WordPress plugin that adds contact form with great flat design and flyout animation effect on every page of your site. Plugin form is responsive to screen size changes, works well on mobile devices and reacts on swipe gestures.

Installation

  1. Unzip plugin archive.
  2. Place ninja-contact-form folder into the .../wp-content/plugins/ directory of your site.

Or you can do the second part in more handy way via WordPress Admin panel:

  1. On the Plugins panel press the Add New button.
  2. Press Upload tab.
  3. Browse for the downloaded zip file, select it, press Open.
  4. Click Install Now.

Files Structure

Ninja Kick: Contact Form has standard WordPress plugin structure. It includes both PHP files for server-side and JavaScript files to operate on client-side. Main plugin file main.php generates form HTML and injects JS (like main JS ninja-contact-form.js and required JS libraries based on WordPress jQuery) from /js folder and CSS from /css folder on your site page.

Source code: PHP and JavaScript

Plugin main PHP class is defined in main.php_. It provides standard WordPress plugin routine like settings and appearance presentation in admin and settings storage in WordPress database and also includes other .php files and injects .js, .css for browser pages. Nothing really to customize here, only in case of new functionality addition.

  • Files options-page.php and settings.php are both dedicated to handle settings page presentation and scripting.
  • Dynamic content generation takes place in ninja-contact-form.php. There can be found base HTML for sidebar.
  • Logic of how form works on your page is encapsulated in ninja-contact-form.js. Form setup, animations, form validation can be found here. If you want to change something of this stuff you should edit this file.

IMPORTANT: by default plugin uses minified ninja-contact-form.min.js to optimize page load but editing of this file is much harder. We suggest you to switch to non-minified ninja-contact-form.js. Search for string ninja-contact-form.min.js in main.php and change path. Then edit this file (found in /js folder) and minify it here. Save as new ninja-contact-form.min.js.

This plugin imports two Javascript files only on Settings page:

  1. jQuery plugin tinycolor.js to work with colors.
  2. jQuery Colorpicker UI plugin jquery.colorpickersliders.js.

Design: CSS and images

We use two CSS files in this theme. The first one admin.css is for plugin styles in WordPress admin like settings page. The second file ninja-contact-form.css contains all of the specific stylings for the panel on your site pages.

Feel free to edit any of this CSS. Please double-check if editing more than just font or background color.

Usage

By default only way to expose sidebar is to click on label with icon. Plugin doesn’t generate buttons by itself, it looks for exact class ncf_trigger_element on page. If element with this class exists click on it will expose sidebar. You need manually add class to desired element like this:

<a class="my_theme_standard_button ncf_trigger_element" href="#">EXPOSE FORM!</a>

Also you can call form API methods NinjaSidebar.showSidebar() and NinjaSidebar.hideSidebar() from your JS code to control form visibility on certain conditions.

Browser support

  • Chrome >= 20
  • Mozilla Firefox >= 15
  • Internet Explorer >= 8
  • Safari >= 5
  • Opera >= 12
  • Safari Mobile for iOS
  • Chrome for Android / iOS
  • Firefox for Android

Dependencies

Only dependency is jQuery equal or greater than 1.7 version.

Support

To get support for any our product please visit our Help Center. Our Help Center is the only official Looks Awesome support handling mechanism. Questions sent using other channels may be ignored without notice. Check out our Support Policy.