{"id":2479,"date":"2008-02-10T02:52:26","date_gmt":"2008-02-10T02:52:26","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/progpress\/"},"modified":"2016-11-03T09:50:04","modified_gmt":"2016-11-03T09:50:04","slug":"progpress","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/progpress\/","author":97662,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.2","stable_tag":"1.2.2","tested":"4.6.30","requires":"2.2","requires_php":"","requires_plugins":"","header_name":"ProgPress","header_author":"Jason Penney","header_description":"","assets_banners_color":"","last_updated":"2016-11-03 09:50:04","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/jasonpenney.net\/donate","header_plugin_uri":"http:\/\/jasonpenney.net\/wordpress-plugins\/progpress\/","header_author_uri":"http:\/\/jasonpenney.net\/","rating":4.5,"author_block_rating":0,"active_installs":10,"downloads":63468,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.1":"<p>This version adds a new plugin for NaNoWriMo.  Just use [progpress\nnanowrimo=<em>uid<\/em>] to track your progress!<\/p>","1.0":"<p>This version adds the [progpress] shortcode, option to enable (all)\nshortcodes in text widgets, pretty printing of large numbers, optional\nprefix ($, etc.), markup tweaks to allow more styling flexibility, and\nmore. Upgrade today!<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":"1","5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1","0.8","0.8.1","0.8.5","0.8.6","1.0","1.1","1.2","1.2.1","1.2.2"],"block_files":[],"assets_screenshots":{"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1567419","resolution":"4","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1567419","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1567419","resolution":"3","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1567419","resolution":"1","location":"plugin"}},"screenshots":{"1":"<p>This meter was generated using the default styles.<\/p>\n\n<pre><code>    [progpress title=\"defaults\" goal=\"180000\" current=\"73023\" previous=\"71398\" label=\"words\"]\n<\/code><\/pre>","2":"<p>Make the meter blue and remove padding.<\/p>\n\n<pre><code>div.jcp_pp_meter { \n    padding: 0; \n}\ndiv.jcp_pp_prog { \n    background-color: #22a; \n}\ndiv.jcp_pp_new { \n    background-color: #22f; \n}\n\n\n [progpress tile=\"Test\" goal=\"50000\" current=\"48000\"]\n<\/code><\/pre>","3":"<p>Blue meters with 3D borders.<\/p>\n\n<pre><code>div.jcp_pp_meter { \n   padding: 0;\n   height: 30px; \n   border: inset 4px #aaa; \n   background-color: #aaa; \n   z-index: 1; \n   overflow: visible; \n}\ndiv.jcp_pp_prog, div.jcp_pp_new { \n    border: outset 4px red; \n    margin-left: -4px; \n    margin-top: -4px; \n    z-index: 2; \n    background-color: #22a; \n    border-color:#22a;\n}\ndiv.jcp_pp_new { \n    border-color:#22f; \n    background-color: #22f; \n    border-left: none; \n    z-index: 3; \n}\n<\/code><\/pre>\n\n<blockquote>\n  <p><code>[progpress title=\"Test Too\" goal=\"100000\" current=\"70000\" previous=\"67000\"]<\/code><\/p>\n<\/blockquote>","4":"<p>Image Based<\/p>\n\n<pre><code>div.jcp_pp_meter { \n    padding: 0; \n    height: 33px; \n    background-image: url(pp_bg_remain.jpg); \n}\ndiv.jcp_pp_prog,div.jcp_pp_new {\n   background-image:url(pp_bg_current.jpg); \n}\n\n\n [progpress title=\"Test Also\" goal=\"500\" current=\"350\" label=\"pages\"]\n<\/code><\/pre>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2569,2509,17061,9340,4045],"plugin_category":[36,45,46],"plugin_contributors":[78096],"plugin_business_model":[],"class_list":["post-2479","plugin","type-plugin","status-publish","hentry","plugin_tags-bar","plugin_tags-graph","plugin_tags-meter","plugin_tags-progress","plugin_tags-wordcount","plugin_category-analytics","plugin_category-ecommerce","plugin_category-editor-and-writing","plugin_contributors-jczorkmid","plugin_committers-jczorkmid"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/progpress.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/progpress\/trunk\/screenshot-1.png?rev=1567419","caption":"<p>This meter was generated using the default styles.<\/p>\n\n<pre><code>    [progpress title=\"defaults\" goal=\"180000\" current=\"73023\" previous=\"71398\" label=\"words\"]\n<\/code><\/pre>"},{"src":"https:\/\/ps.w.org\/progpress\/trunk\/screenshot-2.png?rev=1567419","caption":"<p>Make the meter blue and remove padding.<\/p>\n\n<pre><code>div.jcp_pp_meter { \n    padding: 0; \n}\ndiv.jcp_pp_prog { \n    background-color: #22a; \n}\ndiv.jcp_pp_new { \n    background-color: #22f; \n}\n\n\n [progpress tile=\"Test\" goal=\"50000\" current=\"48000\"]\n<\/code><\/pre>"},{"src":"https:\/\/ps.w.org\/progpress\/trunk\/screenshot-3.png?rev=1567419","caption":"<p>Blue meters with 3D borders.<\/p>\n\n<pre><code>div.jcp_pp_meter { \n   padding: 0;\n   height: 30px; \n   border: inset 4px #aaa; \n   background-color: #aaa; \n   z-index: 1; \n   overflow: visible; \n}\ndiv.jcp_pp_prog, div.jcp_pp_new { \n    border: outset 4px red; \n    margin-left: -4px; \n    margin-top: -4px; \n    z-index: 2; \n    background-color: #22a; \n    border-color:#22a;\n}\ndiv.jcp_pp_new { \n    border-color:#22f; \n    background-color: #22f; \n    border-left: none; \n    z-index: 3; \n}\n<\/code><\/pre>\n\n<blockquote>\n  <p><code>[progpress title=\"Test Too\" goal=\"100000\" current=\"70000\" previous=\"67000\"]<\/code><\/p>\n<\/blockquote>"},{"src":"https:\/\/ps.w.org\/progpress\/trunk\/screenshot-4.png?rev=1567419","caption":"<p>Image Based<\/p>\n\n<pre><code>div.jcp_pp_meter { \n    padding: 0; \n    height: 33px; \n    background-image: url(pp_bg_remain.jpg); \n}\ndiv.jcp_pp_prog,div.jcp_pp_new {\n   background-image:url(pp_bg_current.jpg); \n}\n\n\n [progpress title=\"Test Also\" goal=\"500\" current=\"350\" label=\"pages\"]\n<\/code><\/pre>"}],"raw_content":"<!--section=description-->\n<p><em>ProgPress<\/em> provides a simple\n<a href=\"http:\/\/codex.wordpress.org\/Shortcode\">shortcode<\/a> for creating\nprogress meters on your WordPress site.  They can be used to track\njust about anything where you count up towards a goal: word-count,\nfundraising, etc.  You can put them in individual posts and pages, or\ninclude them in text widgets.<\/p>\n\n<p>To insert a meter simply use the <code>[progpress]<\/code> shortcode:<\/p>\n\n<pre><code>[progpress title=\"My Project\" goal=\"100000\" current=\"1234\"]\n<\/code><\/pre>\n\n<p>The <code>[progpress]<\/code> shortcode has the following options:<\/p>\n\n<ul>\n<li>Required:\n\n<ul>\n<li><strong><code>title<\/code><\/strong>: A string containing The title for your meter.<\/li>\n<li><strong><code>goal<\/code><\/strong>: A number.  The one you are working towards.<\/li>\n<li><strong><code>current<\/code><\/strong>: A number showing how far along you are.<\/li>\n<\/ul><\/li>\n<li>Optional:\n\n<ul>\n<li><strong><code>previous<\/code><\/strong>: You can put your previous value of <code>current<\/code> here\nif you want to highlight your most recent progress update.  It's\nnot visible using the default styling (but it doesn't hurt\nanything). <\/li>\n<li><strong><code>label<\/code><\/strong>: What it is that you're counting, like <code>\"words\"<\/code> for\nexample.<\/li>\n<li><strong><code>separator<\/code><\/strong>: A character or string to display between\ncurrent and <code>goal<\/code>. Defaults to <code>\"\/\"<\/code>.<\/li>\n<li><strong><code>class<\/code><\/strong>: An extra CSS class to apply to the meter container.\nUseful if you track different projects with different styles.<\/li>\n<li><strong><code>prefix<\/code><\/strong>: A character or string to display before each number\n(like '$'). Off by default.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p><em>ProgPress<\/em> was designed to be customizable via CSS.  I've provided\nsome examples in the <em>Screenshots<\/em> section.<\/p>\n\n<h3>NaNoWriMo Support<\/h3>\n\n<p>If you are participating in NaNoWriMo, ProgPress can automatically\ntrack your progress.  Just enable the additional <em>ProgPress -\nNaNoWriMo Support<\/em> plugin (in addition to ProgPress), and set the\n    nanowrimo attribute to your NaNoWriMo <em>username<\/em> (this is a change\nfrom last year where your user id was used).<\/p>\n\n<pre><code>[progpress title=\"My NaNoWriMo Progress\" nanowrimo=\"jczorkmid\" label=\"words\"]\n<\/code><\/pre>\n\n<p>So as to not overload their servers, the plugin caches your word count\ninfo, so it may not update immediately when you update your word count\nat nanowrimo.org.<\/p>\n\n<p>Note that as of November 10, 2011 the NaNoWriMo Word Count API is\nnot yet officially released.  At times it seems to return invalid\nerrors saying your user doesn't exist, or you don't have a novel in\nprogress this year.  In my testing this clears itself up after a bit,\nand once some data has been loaded WordPress will cache it rather than\ncontinue to display errors if it keeps going up and down.<\/p>\n\n<h3>More Info<\/h3>\n\n<ul>\n<li>Check out my <a href=\"http:\/\/jasonpenney.net\/wordpres-plugins\/\">other WordPress\nplugins<\/a>.<\/li>\n<li>Check out this excellent <a href=\"http:\/\/www.penrefe.com\/2010\/09\/07\/progpress-setup-customisation-guide\/\">ProgPress Setup &amp; Customization\nGuide<\/a>\nfor some additional CSS examples.<\/li>\n<\/ul>\n\n<h3>Thanks<\/h3>\n\n<p>Special thanks to <a href=\"http:\/\/kjtoo.com\/\">Kris Johnson<\/a>,\n<a href=\"http:\/\/www.penrefe.com\/\">K. L. Kerr<\/a>, <a href=\"http:\/\/ctmiller.net\/\">Chris\nMiller<\/a>, <a href=\"http:\/\/www.inkygirl.com\/\">Debbie Ohi<\/a>,\nand <a href=\"http:\/\/scottphillips.org\/\">Scott Philips<\/a> for their feedback and\nsupport.<\/p>\n\n<!--section=installation-->\n<p>Extract the zip file and just drop the contents in the\n    wp-content\/plugins\/ directory of your WordPress installation and then\nactivate the Plugin from Plugins page.<\/p>\n\n<p>You can configure the options from the settings page.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>I'm seeing the shortcode source when I try and use it in a text widget.<\/dt>\n<dd><p>As of this writing WordPress does not support shortcodes in text\nwidgets. <em>ProgPress<\/em> has the ability to enable all shortcodes in\ntext widgets (not just <code>[progpress]<\/code>), but it is turned off by\ndefault.  It can be enabled on the <em>ProgPress<\/em> settings page.<\/p>\n\n<p>The code is based on a proposed patch to WordPress core. Hopefully\nthis feature is added to WordPress itself at some later date. I've\ntried to code defensively so if the feature is added to WordPress in\nthe future, having it enabled in the plugin should not have any negative\nside effects.<\/p><\/dd>\n<dt>What are the default styles?  What does the markup look like?<\/dt>\n<dd><p>Please check out the <strong>Examples<\/strong> section on the settings page.  It\nwill generate markup and display the default styles for the currently\ninstalled version of <em>ProgPress<\/em> when you click \"Load Examples\".  I've\ndone this rather than put a static copy here that I might forget to\nupdate in future.<\/p><\/dd>\n<dt>What's all this about shortcodes?  I've been using ProgPress in a different way for ages!<\/dt>\n<dd><p>Since <em>ProgPress<\/em> pre-dates shortcodes being added to WordPress it\noriginally used an older syntax based on HTML comments. This syntax is\nstill supported (although newer features like <code>label<\/code> have not been\nback-ported).  It can be enabled on the <em>ProgPress<\/em> settings page.<\/p>\n\n<p>You add a progress meter by including the following in a post or in a\ntext widget:<\/p>\n\n<pre><code>&lt;!--progpress|title|goal|current|previous|label--&gt;\n<\/code><\/pre>\n\n<p>Only these five options are supported, only the first three are\nrequired.<\/p><\/dd>\n<dt>Besides shortcodes and HTML comments, is there any other way I can use ProgPress to generate meters?<\/dt>\n<dd><p>Sure.  You can call the <code>jcp_progpress_generate_meter<\/code> function\ndirectly.<\/p>\n\n<pre><code>&lt;?php if (function_exists('jcp_progpress_generate_meter')){  \n       echo jcp_progpress_generate_meter(\"title\", 100, 50, 25, \"label\");\n}?&gt;\n<\/code><\/pre>\n\n<p>The arguments to the function are: \n    title, <code>goal<\/code>, <code>current<\/code>, <code>previous<\/code>, <code>label<\/code>, <code>separator<\/code>, <code>class<\/code>, \nand <code>prefix<\/code> (in that order).<\/p><\/dd>\n<dt>How will the meter show up in my RSS feeds?<\/dt>\n<dd><p>Inline styles (based on the default styles) are used to ensure the\nmeters render in RSS readers.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Fixed caching timeout (whoops)<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Updated the <em>ProgPress - NaNoWriMo Support<\/em> plugin for 2011<\/li>\n<li>Pretty printing of numbers now handled via <code>number_format_i18n<\/code> for better\ninternational support.<\/li>\n<li>Admin JavaScript should only load on the ProgPress admin page.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added the <em>ProgPress - NaNoWriMo Support<\/em> plugin<\/li>\n<li>Added <code>jcp_progpress_shortcode_atts<\/code> filter<\/li>\n<li>Added phpdoc<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Added the <code>[progpress]<\/code> shortcode.<\/li>\n<li>Pretty print large numbers (inserting commas, etc).<\/li>\n<li>Added <code>class<\/code>, <code>prefix<\/code>, and <code>separator<\/code> options<\/li>\n<li>Added option to enable shortcodes in text widgets.<\/li>\n<li>Rewrote the README (hopefully it's more helpful now).<\/li>\n<li>Added some extra tags to the markup to make it easier to style\nindividual sections.<\/li>\n<\/ul>\n\n<h4>0.8.6<\/h4>\n\n<ul>\n<li>fixed bug with width calculation<\/li>\n<li>provide production and development versions of javascript and css<\/li>\n<\/ul>\n\n<h4>0.8.5<\/h4>\n\n<ul>\n<li>Migrated to new WordPress admin API.<\/li>\n<li>Moved default styles to external style sheet.<\/li>\n<li>Added ability to view default style sheet to settings page.<\/li>\n<li>Added a bit more content to the README.<\/li>\n<\/ul>\n\n<h4>0.8.2<\/h4>\n\n<ul>\n<li>Use inline styles in RSS feeds.<\/li>\n<li>Changed filter priorities to deal with WordPress changes.<\/li>\n<\/ul>\n\n<h4>0.8.1<\/h4>\n\n<ul>\n<li>Added <code>title<\/code> attributes to meter sections.<\/li>\n<li>Better path determination logic.<\/li>\n<\/ul>\n\n<h4>0.8<\/h4>\n\n<ul>\n<li>Removed try\/catch in place of PHP version detection.<\/li>\n<li>Updated styles<\/li>\n<\/ul>\n\n<h4>0.1<\/h4>\n\n<ul>\n<li>initial release<\/li>\n<\/ul>","raw_excerpt":"Easily insert progress meters into your content and\/or sidebars.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/2479","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=2479"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jczorkmid"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=2479"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=2479"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=2479"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=2479"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=2479"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=2479"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}