Contact Details

October 09, 2014

Contact Details Plugin

Adds the ability to easily enter and display contact information.

Adds the ability to enter contact information and output the details in your posts, pages or templates.

Use the shortcode [contact type="phone"] to display any of the contact details, or use the function call <?php if ( function_exists( 'contact_detail' ) ) { contact_detail( 'phone' ); } ?>.

Once you have defined a contact email address, use the shortcode [contact type="form"] to output the contact form.

Languages: Also available in Español (Spanish) and українська (Ukrainian by Michael Yunat).

Installation

Here we go:

  1. Upload the contact folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Enter you contact details on the options page Settings > Contact Details.
  4. Display the details using either the shortcodes or function calls.

Screenshots

  1. The contact details management page.

    The contact details management page.

FAQ

Installation Instructions

Here we go:

  1. Upload the contact folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Enter you contact details on the options page Settings > Contact Details.
  4. Display the details using either the shortcodes or function calls.

How do I edit my contact details?

Navigate to the settings page by clicking on Settings on the left hand menu, and then the Contact Details option.

Can I add extra contact details fields?

Yes, it is possible to modify the contact detail fields using the contact_details filter.

add_filter( 'contact_details', function( $details ) { // Add a simple text input... $details['twitter'] = __( 'Twitter' ); // Add a new textarea... $details['bank'] = array( 'label' => __( 'Bank' ), 'input' => 'textarea' ); // Remove an existing field... unset( details['fax'] ); // You must always return the modified array... return $details; } ); 

What contact details can I store?

Current available contact fields are: phone, fax, mobile, email and address.

How do I include details in my template?

You can use the following function call to output details in your templates:

How do you fetch contact details without outputting the value?

The fourth parameter passed to contact_detail() determines whether the value is returned, by setting the value to false.

$phone = contact_detail( 'phone', '<b>', '</b>', false ); 

The above code will fetch the phone number stored and wrap the response in bold tags.

How can I customise the contact form?

If you require more customisation that cannot be achieved using CSS, you can define your own template file.

To do this add the the attribute include to the shortcode tag, e.g. [contact type="form" include="myfile.php"].

This file should be placed within your theme directory and should include the processing and output of errors.

I suggest you use the contact.php file used by the plugin as a starting point / template.

Can I translate your plugin to another language?

Yes, of course. If you would like to translate this plugin to another language, please provide me with the releavant Poedit files.

I will be certain to include and attribute any contributions to those who provide any translations.

Changelog

0.8.1

  • Readme changes to language list.
  • Set from email as sender email.

0.8

  • Introduced contact-send filter.
  • Ability to disable spamcheck via shortcode using spamcheck="false".

0.7.7

  • Added Ukrainian (uk_UA) language translation.
  • Allow for additional attributes to be passed through to template files.

0.7.6

  • Re-added email address to settings page, lost during recent update.
  • Modified upgrade process to work now that register_activation_hook no longer fires for plugin updates.

0.7.5

  • Corrected new contributor name.

0.7.4

  • Removed old plugin contributor and author details.

0.7.3

  • Resolving the SVN mix-up tagging versions.

0.7.2

  • Integration of i18n abilities, using Spanish (es_ES) as an example.
  • Added the ability to modify the fields shown to the details page.
  • Updated donate link 😉

0.7.1

  • Bug fix to shortcode function call that displays contact details.

0.7

  • Integrated Akismet to check for SPAM submissions. (Requires Akismet Plugin)
  • Improved input / output escaping and added nonce field to contact form.

0.6

  • Added functionality to include a website url as part of the email form.
  • Submitted comments are now checked against the simple blacklist.
  • Updated use of user levels (deprecated) to user roles and capabilities.
  • Contact email address defaults to site admin email.

0.5

  • Added ability to include custom form template.

0.4.3

  • Added class names to contact form rows to allow easier customisation.

0.4.2

  • Fixed PHP warning on settings page if no options existed.

0.4.1

  • Fixed form input ids and labels.

0.4

  • Added contact form.

0.3

  • Fixed errors when error reporting is set to all.
  • Added details screenshot.

0.2

  • The function contact_details now outputs by default instead of having to echo the response.
  • Function calls now includes before, after and echo options.

0.1.1

  • Updated/Corrected plugin name.

0.1

  • This is the very first version.

Details

  • Version: 0.8.1
  • Active installations: 1,000
  • WordPress Version: 3.9
  • Tested up to: 4.0.38

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars