| 1 |
=== WP-Print === |
| 2 |
Contributors: GamerZ |
| 3 |
Donate link: http://lesterchan.net/site/donation/ |
| 4 |
Tags: print, printer, wp-print |
| 5 |
Requires at least: 2.8 |
| 6 |
Tested up to: 4.3 |
| 7 |
Stable tag: 2.56 |
| 8 |
|
| 9 |
Displays a printable version of your WordPress blog's post/page. |
| 10 |
|
| 11 |
== Description == |
| 12 |
|
| 13 |
= Build Status = |
| 14 |
[](https://travis-ci.org/lesterchan/wp-print) |
| 15 |
|
| 16 |
= Development = |
| 17 |
[https://github.com/lesterchan/wp-print](https://github.com/lesterchan/wp-print "https://github.com/lesterchan/wp-print") |
| 18 |
|
| 19 |
= Translations = |
| 20 |
[http://dev.wp-plugins.org/browser/wp-print/i18n/](http://dev.wp-plugins.org/browser/wp-print/i18n/ "http://dev.wp-plugins.org/browser/wp-print/i18n/") |
| 21 |
|
| 22 |
= Credits = |
| 23 |
* Plugin icon by [SimpleIcon](http://www.simpleicon.com) from [Flaticon](http://www.flaticon.com) |
| 24 |
* Icons courtesy of [FamFamFam](http://www.famfamfam.com/) |
| 25 |
|
| 26 |
= Donations = |
| 27 |
I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks as my school allowance, I will really appreciate it. If not feel free to use it without any obligations. |
| 28 |
|
| 29 |
== Installation == |
| 30 |
|
| 31 |
You can either install it automatically from the WordPress admin, or do it manually: |
| 32 |
|
| 33 |
1. Upload the whole `wp-print` directory into your plugins folder(`/wp-content/plugins/`) |
| 34 |
1. Activate the plugin through the 'Plugins' menu in WordPress |
| 35 |
|
| 36 |
Once installed take the following steps to set it up: |
| 37 |
|
| 38 |
1. WP-Print settings page is located in WP-Admin -> Settings -> Print |
| 39 |
1. You Need To Re-Generate The Permalink (WP-Admin -> Settings -> Permalinks -> Save Changes) |
| 40 |
1. Refer To Usage For Further Instructions |
| 41 |
|
| 42 |
= Usage = |
| 43 |
|
| 44 |
1. Open `wp-content/themes/<YOUR THEME NAME>/index.php`. You should place it in single.php, post.php, page.php, etc also if they exist. |
| 45 |
1. Find: `<?php while (have_posts()) : the_post(); ?>` |
| 46 |
1. Add Anywhere Below It: `<?php if(function_exists('wp_print')) { print_link(); } ?>` |
| 47 |
|
| 48 |
* The first value is the text for printing post. |
| 49 |
* The second value is the text for printing page. |
| 50 |
* Default: print_link('', '') |
| 51 |
* Alternatively, you can set the text in 'WP-Admin -> Settings -> Print'. |
| 52 |
* If you DO NOT want the print link to appear in every post/page, DO NOT use the code above. Just type in <strong>[print_link]</strong> into the selected post/page content and it will embed the print link into that post/page only. |
| 53 |
|
| 54 |
|
| 55 |
== Screenshots == |
| 56 |
|
| 57 |
1. Admin Print Options |
| 58 |
2. Print Post Link |
| 59 |
3. Print Page |
| 60 |
|
| 61 |
== Frequently Asked Questions == |
| 62 |
|
| 63 |
= How do I add this to my theme? = |
| 64 |
|
| 65 |
1. Open `wp-content/themes/<YOUR THEME NAME>/index.php` |
| 66 |
You may place it in single.php, post.php, page.php, etc also. |
| 67 |
1. Find: `<?php while (have_posts()) : the_post(); ?>` |
| 68 |
1. Add Anywhere Below It: `<?php if(function_exists('wp_print')) { print_link(); } ?>` |
| 69 |
|
| 70 |
Simply add this code inside the loop ### where you want the print link to display: |
| 71 |
<code> |
| 72 |
if(function_exists('wp_print')) { |
| 73 |
print_link(); |
| 74 |
} |
| 75 |
</code> |
| 76 |
|
| 77 |
= If you do not want to print a portion of your post's content = |
| 78 |
<code> |
| 79 |
[donotprint]Text within this tag will not be displayed when printing[/donotprint] |
| 80 |
</code> |
| 81 |
* The text within [donotprint][/donotprint] will not be displayed when you are viewing a printer friendly version of a post or page. |
| 82 |
* However, it will still be displayed as normal on a normal post or page view. |
| 83 |
* Do note that if you are using WP-Email, any text within [donotprint][/donotprint] will not be emailed as well. |
| 84 |
|
| 85 |
= Custom Template = |
| 86 |
* WP-Print will load 'print-css.css', 'print-posts.php' and 'print-comments.php' from your theme's directory if it exists. |
| 87 |
* If it doesn't exists, it will just load the respective default file that comes with WP-Print. |
| 88 |
* This will allow you to upgrade WP-Print without worrying about overwriting your printing styles or templates that you have created. |
| 89 |
|
| 90 |
|
| 91 |
== Changelog == |
| 92 |
= 2.66 = |
| 93 |
* NEW: Updated print HTML code. Props @Luanramos |
| 94 |
|
| 95 |
= 2.55 = |
| 96 |
* NEW: Bump to 4.1 |
| 97 |
* FIXED: get_the_category_list() optional secondary argument |
| 98 |
* FIXED: Replace font with p |
| 99 |
|
| 100 |
= 2.54 = |
| 101 |
* NEW: Finally there is custom post type support. Props [nimmolo](http://andrewnimmo.org/ "nimmolo"). |
| 102 |
* NEW: Allow Multisite Network Activate |
| 103 |
* NEW: Uses WordPress uninstall.php file to uninstall the plugin |
| 104 |
|
| 105 |
= 2.53 = |
| 106 |
* FIXED: Use get_stylesheet_directory() instead of TEMPLATEPATH |
| 107 |
|
| 108 |
= 2.52 = |
| 109 |
* FIXED: Added nonce to Options. Credits to Charlie Eriksen via Secunia SVCRP. |
| 110 |
|
| 111 |
= 2.51 = |
| 112 |
* NEW: Support for links that start with "//" |
| 113 |
* FIXED: Unable to load WP-Print on Password Protected posts |
| 114 |
|
| 115 |
= 2.50 = |
| 116 |
* NEW: Uses jQuery Framework |
| 117 |
* NEW: [donotprint][/donotprint] ShortCode Will Not Be Displayed As Well When Using WP-Email (Refer To Usage Tab) |
| 118 |
* NEW: Use _n() Instead Of __ngettext() And _n_noop() Instead Of __ngettext_noop() |
| 119 |
* FIXED: Uses $_SERVER['PHP_SELF'] With plugin_basename(__FILE__) Instead Of Just $_SERVER['REQUEST_URI'] |
| 120 |
* FIXED: Nested ShortCode Issues |
| 121 |
|
| 122 |
= 2.40 = |
| 123 |
* NEW: Works For WordPress 2.7 Only |
| 124 |
* NEW: Better Translation Using __ngetext() by Anna Ozeritskaya |
| 125 |
* NEW: Right To Left Language Support by Kambiz R. Khojasteh |
| 126 |
* NEW: Call print_textdomain() In print_init() by Kambiz R. Khojasteh |
| 127 |
* NEW: Replace "text_direction" Option With $text_direction And language_attributes() by Kambiz R. Khojasteh |
| 128 |
* NEW: Added "print-css-rtl.css" by Kambiz R. Khojasteh |
| 129 |
* NEW: Page Title Is Now "Post Title -> Print" Instead Of "Print -> Post Title" by Kambiz R. Khojasteh |
| 130 |
* NEW: Modified "print-css.css" To Hide "comments_controls" Element For Print by Kambiz R. Khojasteh |
| 131 |
* FIXED: Footnotes Referencing Is Now "link1 <sup>[1]</sup>" Instead Of "[1] link1" by Kambiz R. Khojasteh |
| 132 |
* FIXED: Remove chunk_split() As Browser Will Try To Wrap Word Boundaries Based On Page Width by Kambiz R. Khojasteh |
| 133 |
* FIXED: Remove [print_link] ShortCode In Print Pages |
| 134 |
|
| 135 |
= 2.31 = |
| 136 |
* NEW: Works For WordPress 2.6 |
| 137 |
* NEW: Added donotprint ShortCode. See Usage Tab |
| 138 |
* NEW: WP-Print Will Load print-posts.php And print-comments.php Templates From Your Theme Directory First If The Exist |
| 139 |
* FIXED: Replace <center> With <div style="margin: 0px auto 0px auto;"> |
| 140 |
|
| 141 |
= 2.30 = |
| 142 |
* NEW: Works For WordPress 2.5 Only |
| 143 |
* NEW: WP-Print Will Load 'print-css.css' Inside Your Theme Directory If It Exists. If Not, It Will Just Load The Default 'print-css.css' By WP-Print |
| 144 |
* NEW: Uses Shortcode API |
| 145 |
* NEW: Added "Right To Left" And "Left To Right Text" Direction Option |
| 146 |
* NEW: Option To Remove Videos From Post |
| 147 |
* NEW: Duplicate Links Now Uses A Single Number And Printed Only Once By Constantinos Neophytou |
| 148 |
* NEW: <IMG> And <A> Tag Now Matches Single Quotes By Constantinos Neophytou |
| 149 |
* NEW: Uses /wp-print/ Folder Instead Of /print/ |
| 150 |
* NEW: Uses wp-print.php Instead Of print.php |
| 151 |
* NEW: Changed wp-print.php To print-posts.php |
| 152 |
* NEW: Changed wp-print-comments.php To print-comments.php |
| 153 |
* NEW: Changed wp-print-css.css To print-css.css |
| 154 |
* FIXED: Comment Type Not Translated |
| 155 |
|
| 156 |
= 2.20 = |
| 157 |
* NEW: Works For WordPress 2.3 Only |
| 158 |
* NEW: Ability To Embed [print_link] Into Excerpt |
| 159 |
* NEW: wp-print-css.css Now Controls The CSS Styles For The Printer Friendly Page |
| 160 |
* NEW: Disclaimer/Copyright Text Option By Duane Craig |
| 161 |
* NEW: Anchor Link To Comments By Reinventia |
| 162 |
* NEW: Collapsable Comments By Reinventia |
| 163 |
* NEW: Ability To Uninstall WP-Print |
| 164 |
* FIXED: If There Is No Trailing Slash In Your Permalink, WP-Print Will Add It For You |
| 165 |
|
| 166 |
= 2.11 = |
| 167 |
* NEW: Putting [print_link] In Your Post/Page Content Will Display A Link To The Printable Post/Page |
| 168 |
* FIXED: Worked With Polyglot Plugin, Fixed By zeridon |
| 169 |
* FIXED: Wrong URL If Front Page Is A Static Page |
| 170 |
|
| 171 |
= 2.10 = |
| 172 |
* NEW: Added Fam Fam Fam's Printer Icon |
| 173 |
* NEW: Works For WordPress 2.1 Only |
| 174 |
* NEW: Localize WP-Print |
| 175 |
* NEW: Ability To Configure The Text For Print Links Via 'WP-Admin -> Options -> Print' |
| 176 |
* NEW: The Text For Print Links Can No Longer Be Pass To The Function print_link() or print_link_image() |
| 177 |
* FIXED: MUltiple URL Type Fixed By Virgil |
| 178 |
* FIXED: 'Click Here To Print' Will Be Hidden When Printing By Joe (Ttech) |
| 179 |
|
| 180 |
= 2.06 = |
| 181 |
* NEW: Used Default Date/Time Format Under WordPress Options |
| 182 |
* NEW: Added robots: noindex To Printer Friendly Pages |
| 183 |
* NEW: Added rel="nofollow" To All Links Generated By WP-Print |
| 184 |
* FIXED: <abbr> Tag Mixed Up With <a> |
| 185 |
* FIXED: PHP5 Compatibility Issue |
| 186 |
* FIXED: Long URL Will Not Break Into More Than 1 Line |
| 187 |
|
| 188 |
= 2.05 = |
| 189 |
* NEW: Added Print Options In WP Administration Panel Under 'Options -> Print' |
| 190 |
* NEW: Print Administration Panel And The Code That WP-Print Generated Is XHTML 1.0 Transitional |
| 191 |
* FIXED: Comment's Content Formatting |
| 192 |
|
| 193 |
= 2.04 = |
| 194 |
* NEW: Able To Print Comments Together With Post Using $can_print_comments In wp-print.php |
| 195 |
* NEW: Moved wp-print.php To Plugin Folder |
| 196 |
* FIXED: Removed Link From Post Comment Count And Post Category |
| 197 |
|
| 198 |
= 2.03 = |
| 199 |
* NEW: Added Print Image With print_link_image() |
| 200 |
* NEW: Automatically Break To Next Line If Link Contains More Than 100 Chars |
| 201 |
* FIXED: Comment Numbers Showing In Password Protected Post |
| 202 |
|
| 203 |
= 2.02 = |
| 204 |
* FIXED: Able To View Password Protected Blog |
| 205 |
|
| 206 |
= 2.01 = |
| 207 |
* NEW: Compatible With WordPress 2.0 |
| 208 |
* NEW: Automatically Detect Whether You Are Using Nice Permalink |
| 209 |
* NEW: Automated Permalink |
| 210 |
* NEW: Now You Only Need To Insert 1 Line Into Your index.php Of Your Theme |
| 211 |
* NEW: GPL License Added |
| 212 |
* FIXED: Links Not Displaying Properly When Printing More Than 1 Post On A Single Page |
| 213 |
|
| 214 |
= 2.00a = |
| 215 |
* NEW: Permlink For The Page Feature |
| 216 |
|
| 217 |
= 2.00 = |
| 218 |
* NEW: Print Out A Summary Of URLS In The Post At The Bottom Of The Page |
| 219 |
|
