Author Archive

Guidelines for Third-Party Developers

1. Introduction

 This policy establishes guidelines for third-party developers who create plugins, extensions, or add-ons that integrate with or extend Listeo functionality.

These guidelines aim to:

• Help users distinguish between official Listeo products and third-party extensions
• Protect the Listeo brand and ensure quality standards
• Provide clear naming conventions for the developer community
• Prevent user confusion about product origins and support responsibilities

2. Trademark and Naming Guidelines

2.1 Core Principle

Your plugin name must not begin with “Listeo” or any variation thereof. The Listeo name should only be used to indicate compatibility, not as a primary identifier.

2.2 Naming Format

Use your distinctive product name followed by “for Listeo” or “compatible with Listeo.”

Naming Examples

2.3 Prohibited Uses

The following uses of the Listeo trademark are strictly prohibited:

1. Starting your plugin name with “Listeo” – This implies official affiliation
2. Using “Listeo” in your domain name – e.g., listeo-plugins.com, listeoaddons.com
3. Creating portmanteau names – e.g., ListeoX, ListeoPro, ListeoPlus, MyListeo
4. Using the Listeo logo in your product branding or marketing materials
5. Implying official endorsement or partnership without written agreement
6. Using variations or misspellings – e.g., Listio, List-eo, L1steo

2.4 Permitted Uses

You may use the Listeo trademark in the following ways:

• To accurately describe your product’s compatibility: “X for Listeo” or “X compatible with Listeo”
• In product descriptions and documentation to explain functionality
• In tags and keywords for marketplace listings (e.g., ThemeForest, CodeCanyon)
• On your website to truthfully describe Listeo integration or support services

3. Plugin Slug Guidelines

The same naming rules apply to your plugin’s technical slug (folder name and text domain):

• Incorrect: listeo-booking-calendar, listeo_reviews
• Correct: booking-calendar-for-listeo, reviews-manager-listeo

4. Technical Requirements

Third-party plugins should follow these technical best practices:

• Dependency Check: Verify Listeo theme is active before initializing your plugin
• Version Compatibility: Clearly state which Listeo versions your plugin supports
• Hooks and Filters: Use Listeo’s documented action hooks and filters rather than modifying core files
• Coding Standards: Follow WordPress Coding Standards and best practices
• Unique Prefixes: Use your own unique prefix for functions, classes, and database options

5. Support and Responsibility

Please note the following regarding support:

1. PureThemes does not provide support for third-party plugins. Users should contact the plugin developer directly.
2. Third-party developers are solely responsible for their plugin’s functionality, security, and compatibility.
3. We may require disabling third-party plugins before providing support for Listeo-related issues.
4. Third-party plugins should include clear documentation and support contact information.

6. Required Disclaimer

All third-party plugins must include a visible disclaimer in their documentation and/or plugin description stating:

“This plugin is developed and maintained by [Developer Name] and is not affiliated with, endorsed by, or officially connected to PureThemes or Listeo. For support, please contact [your support channel].”

7. Enforcement

PureThemes reserves the right to:

• Request name changes for plugins that violate these guidelines
• Report trademark violations to marketplace platforms (ThemeForest, CodeCanyon, WordPress.org)
• Take legal action in cases of willful trademark infringement
• Update these guidelines as needed with reasonable notice

8. Questions and Contact

If you have questions about these guidelines or need clarification on whether your intended use is permitted, please contact us at support@purethemes.net before releasing your product.

The Listing Description field uses TinyMCE editor on the front-end submission form. By default, it includes basic formatting options, but you can extend it with additional buttons and features using the submit_listing_form_wp_editor_args filter.

Adding Custom Buttons

Add this code to your child theme’s functions.php file:

add_filter( 'submit_listing_form_wp_editor_args', 'my_full_featured_editor' );
function my_full_featured_editor( $args ) {
    $args['tinymce']['plugins'] = 'lists,paste,tabfocus,wplink,wordpress,textcolor,colorpicker,hr,charmap,table,anchor,code';
    $args['tinymce']['toolbar1'] = 'formatselect,bold,italic,underline,strikethrough,|,forecolor,backcolor,|,bullist,numlist,|,link,unlink,|,undo,redo';
    $args['tinymce']['toolbar2'] = 'alignleft,aligncenter,alignright,|,outdent,indent,|,table,|,hr,charmap,|,removeformat,code';
    $args['media_buttons'] = true;
    return $args;
}

The plugins parameter loads required TinyMCE plugins, while toolbar1 and toolbar2 define which buttons appear in each row. Use | as a separator between button groups. Setting media_buttons to true enables the Add Media button for uploading images.

Available Buttons Reference

Text Formatting: bold, italic, underline, strikethrough, formatselect, styleselect, forecolor, backcolor, removeformat

Lists & Alignment: bullist, numlist, alignleft, aligncenter, alignright, alignjustify, outdent, indent

Insert Elements: link, unlink, hr, charmap, anchor, image, media

Advanced: table, code, subscript, superscript, cut, copy, paste, undo, redo