{"id":3786,"date":"2008-09-30T19:25:09","date_gmt":"2008-09-30T19:25:09","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/praized-tools\/"},"modified":"2009-06-26T20:33:57","modified_gmt":"2009-06-26T20:33:57","slug":"praized-tools","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/praized-tools\/","author":205647,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.0.1","stable_tag":"trunk","tested":"2.8","requires":"2.2","requires_php":"","requires_plugins":"","header_name":"Praized Tools","header_author":"<a href=\"http:\/\/www.praizedmedia.com\/\">Praized Media, Inc.<\/a>","header_description":"","assets_banners_color":"","last_updated":"2009-06-26 20:33:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/wordpress.org\/extend\/plugins\/praized-tools\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2127,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.5","1.5.1","1.6","1.7","2.0","2.0.1"],"block_files":[],"assets_screenshots":{"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1573768","resolution":"4","location":"plugin","width":500,"height":364},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"1573768","resolution":"5","location":"plugin","width":500,"height":452},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1573768","resolution":"1","location":"plugin","width":500,"height":561},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1573768","resolution":"2","location":"plugin","width":500,"height":413},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1573768","resolution":"3","location":"plugin","width":500,"height":495}},"screenshots":{"1":"Sample output: Embedded places, post\/page level place aggregation (with microformats goodness), dynamic search results widget, etc.","2":"Praized Searchlet: search tool to facilitate embedding places within your post and\/or pages. We currently have 17+ million places for you to choose from (US and Canada). You can also add new places, just in case.","3":"Samples of the shortcode\/bbcode generated by the Praized Searchlet. You can embed single places, search results, etc. Also shows the Searchlet launcher (Praized logo button).","4":"Praized widget: this widget allows you to embed dynamic searh results or individual places in your WordPress sidebar. Also uses the Praized Searchlet featured above.","5":"Plugin administration screen. <strong>Note<\/strong>: API credentials seen in the picture won't work. You need to <a href=\"http:\/\/praizedmedia.com\/en\/api\/\">get your own<\/a>. :)"}},"plugin_section":[],"plugin_tags":[1556,597,2215,30082,17483],"plugin_category":[43,49,56],"plugin_contributors":[77578,129537],"plugin_business_model":[],"class_list":["post-3786","plugin","type-plugin","status-closed","hentry","plugin_tags-api","plugin_tags-integration","plugin_tags-location","plugin_tags-merchants","plugin_tags-places","plugin_category-customization","plugin_category-maps-and-location","plugin_category-social-and-sharing","plugin_contributors-stephdau","plugin_contributors-sylvaincarle"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/praized-tools.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/praized-tools\/trunk\/screenshot-1.png?rev=1573768","caption":"Sample output: Embedded places, post\/page level place aggregation (with microformats goodness), dynamic search results widget, etc."},{"src":"https:\/\/ps.w.org\/praized-tools\/trunk\/screenshot-2.png?rev=1573768","caption":"Praized Searchlet: search tool to facilitate embedding places within your post and\/or pages. We currently have 17+ million places for you to choose from (US and Canada). You can also add new places, just in case."},{"src":"https:\/\/ps.w.org\/praized-tools\/trunk\/screenshot-3.png?rev=1573768","caption":"Samples of the shortcode\/bbcode generated by the Praized Searchlet. You can embed single places, search results, etc. Also shows the Searchlet launcher (Praized logo button)."},{"src":"https:\/\/ps.w.org\/praized-tools\/trunk\/screenshot-4.png?rev=1573768","caption":"Praized widget: this widget allows you to embed dynamic searh results or individual places in your WordPress sidebar. Also uses the Praized Searchlet featured above."},{"src":"https:\/\/ps.w.org\/praized-tools\/trunk\/screenshot-5.png?rev=1573768","caption":"Plugin administration screen. <strong>Note<\/strong>: API credentials seen in the picture won't work. You need to <a href=\"http:\/\/praizedmedia.com\/en\/api\/\">get your own<\/a>. :)"}],"raw_content":"<!--section=description-->\n<p>The Praized Tools plugin will enable new editorial tools within your WordPress\ninstall for you to blog about places and tie everything back to your or a 3rd\nparty's Praized community. It will also help you create your Praized sidebar\nwidget.<\/p>\n\n<p><strong>NOTE<\/strong>: The Praized Tools plugin <strong>now comes pre-configured<\/strong> with a read-only\nAPI key that will link back to our <a href=\"http:\/\/praized.com\/\">Praized.com Hub<\/a> by default.<\/p>\n\n<p>If you decide to also install our <a href=\"http:\/\/wordpress.org\/extend\/plugins\/praized-community\/\">Praized Community<\/a>\nplugin, you can optionally set the Praized Tools plugin to use the same <a href=\"http:\/\/praizedmedia.com\/en\/api\/\">API key<\/a>\nyou will acquire for your own community. If so, the Praized Tools will then link back\nto your own site instead of our <a href=\"http:\/\/praized.com\/\">Praized.com Hub<\/a>. These setting\ncan be changed at any time.<\/p>\n\n<p>This plugin is designed for use with the latest version of WordPress, but will\nwork with versions 2.2 and newer. Our plugins also support WordPress MU 1.3+.<\/p>\n\n<p><strong>See also<\/strong>: The <a href=\"http:\/\/wordpress.org\/extend\/plugins\/praized-community\/\">Praized Community<\/a> plugin (requires PHP5).<\/p>\n\n<h3>Using the Plugin<\/h3>\n\n<p>Once the plugin is installed, activated and the API credentials have been\nconfigured, you will now see an extra button in the WordPress post and page\neditor.<\/p>\n\n<p>In visual mode (TinyMCE), the new button is a small praized icon.<\/p>\n\n<p>In HTML mode, the new button is simply a new form button.<\/p>\n\n<p>Clicking on the said button will launch the Praized Searchlet, a place\/merchant\nresearch tool. Once you have located the merchant you are interested in embedding\nin your post\/page, simply use the \"Embed this place\" functionality (or \"Embed\nthis query\" for search results).<\/p>\n\n<p>Once configured to your liking, the searchlet will generate a short code, usually\nknown as bbcode, shortcode or markdown ([praized ...]) that will be translated to\nXHTML when your post or page is viewed by your readers. You can preview how the\noutput will look like by using the WP post\/page preview features.<\/p>\n\n<p>You can also access the Praized Searchlet's functionality by assigning the Praized\nWidget in WP Admin -&gt; Design -&gt; Widgets. This will allow you to feature a specific\nplace, or search result, in your WordPress sidebars.<\/p>\n\n<p>If your WordPress install is already setup to use WP caching, you can turn on\ncaching for our embedded badges and lists through the Praized Tools admin screen.\nThis will speed up page rendering in high traffic site by inssuring that the\nplugin does not connect to our API at each pageload, but simply refreshes the\ndata at your desired interval. Please note that when using advanced WP caching\nplugins such as WP-Super-Cache, the said plugin's caching configuration might\ntake precedence over ours (TTL, static files, etc).<\/p>\n\n<p>Developers can also find our generated <a href=\"http:\/\/phpdoc.org\">phpdoc<\/a>\ndocumentation output in \/wp-content\/plugins\/praized-tools\/phpdocs\/.<\/p>\n\n<h3>Third Party Plugins\/Themes Integration<\/h3>\n\n<p>Although not as advanced as the development tools we make available with our\nPraized Community plugin, we have still enabled a few basic API integration\nfunction within the praized-tools.php plugin file.<\/p>\n\n<ul>\n<li>pzdt_merchants_get(): returns a list, as PHP object<\/li>\n<li>pzdt_merchants_search(): returns a search result, as PHP object<\/li>\n<li>pzdt_merchant_get(): returns an individual merchant\/place, as PHP object<\/li>\n<li>pzdt_user_get(): returns an individual raized user, as PHP object<\/li>\n<li>and more<\/li>\n<\/ul>\n\n<p><strong>See also<\/strong>: generated code documentation in \/wp-content\/plugins\/praized-tools\/phpdocs\/<\/p>\n\n<h3>Internationalization<\/h3>\n\n<p>The Praized Tools plugin is completely translatable out of the box and comes\nwith English and French bundles by default..<\/p>\n\n<p>You can find the localization template you can use to translate the plugin in\n\/wp-content\/plugins\/praized-tools\/includes\/localization.<\/p>\n\n<p>See the <a href=\"http:\/\/codex.wordpress.org\/Translating_WordPress\">WordPress Codex<\/a> for details.<\/p>\n\n<p>Should you decide to take the time to translate our plugin(s) in your favorite\nlanguage before we have a chance to do so ourselves, please feel free to get\nin touch with us so we can consider bundling your translation directly with\nour source in future releases. http:\/\/new.praizedmedia.com\/en\/contact<\/p>\n\n<!--section=installation-->\n<h3>Upgrading From A Previous Version<\/h3>\n\n<p>To upgrade from a previous version of this plugin, delete the entire folder and\nfiles from the previous version of the plugin and then follow the installation\ninstructions below.<\/p>\n\n<h3>Installing The Plugin<\/h3>\n\n<p>Extract all files from the ZIP file, making sure to keep the file structure intact,\nand then upload the plugin's folder to <code>\/wp-content\/plugins\/<\/code>.<\/p>\n\n<p>This should result in something very similiar to the following file structure:<\/p>\n\n<pre><code>- wp-content\n  - plugins\n    - praized-tools\n      | license.txt\n      | praized-tools.php\n      | readme.txt\n      - includes\n        - [ ... ]\n<\/code><\/pre>\n\n<p>Then visit your admin area and activate the plugin and follow the onscreen\ninstructions.<\/p>\n\n<p>Once you have received your API access credentials, go to the plugin's\nconfiguration screen in \"Admin -&gt; Settings -&gt; Praized Tools\" and fill in\nthe appropriate options with the information provided to you by Praized Media\nwhen you <a href=\"http:\/\/praizedmedia.com\/en\/api\/\">request access to our API<\/a>.<\/p>\n\n<p><strong>See Also:<\/strong> <a href=\"http:\/\/codex.wordpress.org\/Managing_Plugins#Installing_Plugins\">\"Installing Plugins\" on the WP Codex<\/a>.<\/p>\n\n<!--section=changelog-->\n<p>Version 2.0.1: 2009-06-26<\/p>\n\n<ul>\n<li>Updated to praized-php-2.0.1.<\/li>\n<\/ul>\n\n<p>Version 2.0: 2009-04-29<\/p>\n\n<ul>\n<li>New sidebar widgets for latest questions, latest answers and latest activity.<\/li>\n<li>Plugin now comes bundled with full French translation if running WordPress in French.<\/li>\n<li>Updated to praized-php-2.0.<\/li>\n<li>Updated to praized-wp-core-2.0.<\/li>\n<\/ul>\n\n<p>Version 1.7: 2009-01-12<\/p>\n\n<ul>\n<li>Tweaked the javascript handling for the administration searchlet and fixed a potential\njquery issue with the version bundled with WordPress.<\/li>\n<li>Updated to praized-php-1.7.<\/li>\n<li>Updated to praized-wp-core-1.7.<\/li>\n<\/ul>\n\n<p>Version 1.6: 2008-12-05<\/p>\n\n<ul>\n<li>The Praized Tools plugin now comes with a default read-only API key that will link\nback to the Praized Hub (http:\/\/praized.com\/) so you can be up and running within seconds.<\/li>\n<li>Implemented the improvements to the place aggregation options added in the praized-php\nlibrary, so any kind of Praized place URLs can be parsed and presented\n(http:\/\/praized.com\/places\/..., http:\/\/praized.com\/merchants\/..., http:\/\/przd.com\/...). <\/li>\n<li>Updated to praized-php-1.6 to implement the new place resolver API methods.<\/li>\n<li>Updated to praized-wp-core-1.6 to implement the new place resolver API methods.<\/li>\n<\/ul>\n\n<p>Version 1.5.1: 2008-10-24<\/p>\n\n<ul>\n<li>Updated to praized-php-1.5.1 to implement a security in the 3rd-party Snoopy library<\/li>\n<\/ul>\n\n<p><strong>Version 1.5: 2008-09-30<\/strong><\/p>\n\n<ul>\n<li>Added support for post\/page level place aggregation (see admin screen)<\/li>\n<li>Added 16 vote button themes and an option in the admin to select your favorite one.\nWill use the vote button theme from Praized Community if active.\nYou can still overwrite this in CSS by changing the background options on and\nwithin .praized-vote-button.<\/li>\n<li>Improved the overall appearance and usability of the plugin's admin\/settings screen<\/li>\n<li>The Praized plugins are now officialy hosted on wordress.org and wp-plugins.org.\nThis means that if you install the plugins from there, you will now be automatically\nnotified whenever we release an upgradedirectly in the WP admin, and other niceties.<\/li>\n<li>Updated to praized-php-1.5, whith major improvements supporting some of the new\nfeatures implemented in this release.<\/li>\n<li>Updated to praized-wp-core-1.5, whith major improvements supporting some of the\nnew features implemented in this release.<\/li>\n<\/ul>\n\n<p><strong>Version 1.0.4: 2008-09-02<\/strong><\/p>\n\n<ul>\n<li>Updated to praized-php-1.0.4<\/li>\n<li>Updated to praized-wp-core-1.0.4<\/li>\n<\/ul>\n\n<p><strong>Version 1.0.3: 2008-08-05<\/strong><\/p>\n\n<ul>\n<li>New convenience button in admin to reuse the praized-community credentials if available and valid<\/li>\n<li>Updated to praized-php-1.0.3<\/li>\n<li>Updated to praized-wp-core-1.0.3<\/li>\n<\/ul>\n\n<p><strong>Version 1.0.2: 2008-07-22<\/strong><\/p>\n\n<ul>\n<li>Updated to praized-php-1.0.2<\/li>\n<li>Updated to praized-wp-core-1.0.2<\/li>\n<\/ul>\n\n<p><strong>Version 1.0.1: 2008-07-14<\/strong><\/p>\n\n<ul>\n<li>Better PHP4 compatibility<\/li>\n<li>Updated to praized-php-1.0.1 (PHP4 compat updates)<\/li>\n<li>Updated to praized-wp-core-1.0.1 (PHP4 compat updates)<\/li>\n<li>Localization updates<\/li>\n<\/ul>\n\n<p><strong>Version 1.0: 2008-07-09<\/strong><\/p>\n\n<ul>\n<li>Inital release.<\/li>\n<\/ul>","raw_excerpt":"The Praized Tools plugin is primarily a companion tool for our\nPraized Community\nplugin. It will enable new editorial tools within your WordPress inst &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/3786","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=3786"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/stephdau"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=3786"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=3786"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=3786"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=3786"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=3786"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=3786"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}