Dragons Print-Hint

There are several reasons to print some hints on your posts. These hints will never been seen on the screen, but you want it to show on paper.

Feature-List:

• Definition of a hint text, only appearing on printouts.
  You can use any html tag that can be placed within <p> ... </p> to format your hints.
• Comfortable definition of hint text via admin settings panel.
• Hiding user defined areas of posts / pages – see Example 3 in Arbitrary section
• ShortTag [PrintHint] for free definition of post-blocks show only on screen/print output
• Definition of CSS classes (.classname) in a comma separated list. These classes don’t appear on printouts.
• Definition of CSS IDs (#idname) in a comma separated list. These IDs don’t appear on printouts.
• Style definition for printout border frame
• Multilanguage Support: English, Deutsch, Russian already implemented

The plugin hooks into the_content filter. The the_excerpt filter hook is used to remove the hint from displaying on search result page.

*Scenarios*

You want to show a text only online?

[PrintHint show_on=”screen”] … appears only on screen … [/PrintHint]

You want to show a text only on printout?

[PrintHint show_on=”print”] … appears only on printouts … [/PrintHint]

*Hint*

Beware of the closing tag [/PrintHint] as well as the parameter show_on, they are REQUIRED!
If you don’t apply the parameter or give them a wrong argument, the block content will not be displayed, anyway.

Removing the whole border css style from config page will activate the default style defined in fdrag_phi_print.css

Arbitrary section

Example 1: Hint-Text

<center><b>Achtung</b> - Urheberrechtshinweis! <br>
Da dieses Blog unter einer Creative Commons Lizenz steht, 
stellt das Ausdrucken für Sie kein Problem dar. <br>
Bei Webseiten die nicht unter einer solchen oder ähnlichen Lizenz stehen, 
kann das Ausdrucken zu einer Urheberrechtsverletzung führen.</center>

Example 2: CSS Class/ID hiding

#header, #top, #footer, #bottom, #sidebar,
.commentheader, #commentform

Example 3: Hide some portion of a post / page while printing

Within the post define an area with a userdefined and no more referenced ID.
This ID don’t have to be defined within any CSS stylesheet. It’s just for Dragons Print-Hint.

.. some content of your post
<div id="RemoveOnPrint"> ... here is some content of the post ... </div>
.. some more content of your post

If you define this ID (#RemoveOnPrint) in the “hide css blocks” list (remember: comma separate more then one value)
you can see the post with all content but while printing the div tag with id=”RemoveOnPrint” ist hidden.

Example 4: Using shortcodes

If there are areas within your post to explicitly hide/show on screen/print output,
you can use the shortcode

[PrintHint show_on="screen|print"] .... [/PrintHint].

Show graphical link only online, on printouts show the URL instead.

Here is my post text
[PrintHint show_on="screen"]<a href="some url"><img src="myImage" /></a>[/PrintHint]
[PrintHint show_on="print"]http://myUrl[/PrintHint]<br>
and here is the rest of the text.

The Parameter show_on can be used to define the apperance of the content between the shortcode tags.
If you define show_on=”screen” the content part will only be shown an screen outputs.
Otherwise, the show_on=”print” parameter will show the hint only on printouts.

Remark: If you dont’t use the ‘show_on’ parameter or forget to close the shortcode tag, there will be no output!

= Example 5: Using your own border style for print-hint
Just enter the border attributes (see http://www.w3schools.com/css/pr_border.asp for usage example)
without the semicolon. e.g. 5px solid red