WordPress.org

Custom Theme/Plugin/Language Integration

You can find our generated phpdoc documentation output in /wp-content/plugins/praized-community/phpdocs/

Template Development

Definitions: * template: Wordpress template skeleton that calls the WP headers, sidebars, etc, as well as the targeted Praized functionality (see fragment). * fragment: We have separated our display logic into reusable mini-templates so that you can modify the templates without worrying about our functionality, or even embed the said fragments in your non-Praized WP templates with ease. Note that by convention, fragment filenames start with an underscore.

We have put a lot of efforts into making sure that the default templates delivered with the Praized Community plugin (/wp-content/plugins/praized-community/includes/php/templates/) works well with most WordPress themes out of the box.

For a custom look, the easiest way to customize the interface of the Praized Community plugin output is to simply overwrite all or part of our bundled CSS with your own, within your theme's stylesheet, by targetting our XHTML through the namespaced id/classes parameters (id/class="praized-...").

But to allow development that extends far beyond what CSS allows for, theme designers can also fully customize the look and feel of their Praized local search functionality by creating their own templates or template fragments, using our global template functions, or by even using the latter functions and template fragments within their standard WordPress theme templates.

Before loading any of the Praized Community templates, we check if a replacement template or template fragment exists within the currently activated theme's directory. If one exists, we will use your template instead of our default one.

To create a custom replacement template or template fragment, simply create a "praized-community" directory within your current theme's directory (/wp-content/themes/your_theme/praized-community) and copy the default template or fragment you want to overwrite into it before applying your customizations.

EG 1: Your theme uses a three-columns layout, as opposed to the two-columns, Kubrick-based one we ship by default:

Simply copy the template files (those not starting by an underscore [_]) found at the top level of /wp-content/plugins/praized-community/includes/php/templates/ to /wp-content/themes/your_theme/praized-community/ and modify the interface skeletons as desired using the usual WP functions.

EG 2: You want to customize the way we display an individual place's:

Simply copy /wp-content/plugins/praized-community/includes/php/templates/merchant/profile.php to /wp-content/themes/yourtheme/praized-community/merchant/_profile.php and modify the layout as desired by using the global template functions found in /wp-content/plugins/praized-community/includes/php/functions/.

See also: generated code documentation in /wp-content/plugins/praized-community/phpdocs/

Third Party Plugins Integration

WordPress plugins developer can also integrate with the Praized Community functionality by using the custom global template functions found in /wp-content/plugins/praized-community/includes/php/functions/ or by interacting with our php classes directly (PraizedCommunity, Praized, etc).

See also: generated code documentation in /wp-content/plugins/praized-community/phpdocs/

With time, we are also planning to make use of the WordPress action/filter hooks machanism to allow for even more third party integration.

Internationalization

The Praized Community plugin is completely translatable out of the box and comes with English and French bundles by default..

You can find the localization template you can use to translate the plugin in /wp-content/plugins/praized-community/includes/localization.

See the WordPress Codex for details.

Should you decide to take the time to translate our plugin(s) in your favorite language before we have a chance to do so ourselves, please feel free to get in touch with us so we can consider bundling your translation directly with our source in future releases. http://new.praizedmedia.com/en/contact