====== PageImage Plugin ======

---- plugin ----
description: pageimage is a syntax/helper plugin which gets an image related to a page for displaying it with pagelist
author     : lisps, peterfromearth  
email      : coder@peterfromearth.de
type       : syntax,helper
lastupdate : 2018-10-12
compatible : Greebo, "Frusterick Manners", "Elenor Of Tsort", Detritus
depends    : pagelist
conflicts  : 
similar    : 
tags       : image,pagelist

downloadurl: https://github.com/lisps/pageimage/archive/master.zip
bugtracker : https://github.com/lisps/pageimage/issues
sourcerepo : https://github.com/lisps/pageimage/
donationurl: 

screenshot_img : https://github.com/lisps/pageimage/raw/558842b735d37417c61ef760ef695fa92e8c6c29/example/example.png
----

Together with pageimage, the [[plugin:pagelist]] plugin can display an image related to the page.

<code>
<pagelist&image>
  * [[pages:page1]]
  * [[pages:page2]]
</pagelist>
</code>

{{https://github.com/lisps/pageimage/raw/558842b735d37417c61ef760ef695fa92e8c6c29/example/example.png}}

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====
There are 4 ways in which pageimage can find an image related to a page. 
^ Defined | ''~~PAGEIMAGE:wiki:dokuwiki-128.png~~''|
^ Convention | image with same id in same namespace (extension jpg/png/jpeg) |
^ Firstimage | the first image in the page is used |
^ Default Image | defined in admin config |

===== Examples/Usage with Pagelist plugin =====
To display images with the pagelist plugin just use the ''&image'' flag

{{https://github.com/lisps/pageimage/raw/558842b735d37417c61ef760ef695fa92e8c6c29/example/example.png}}

===== Syntax =====

To explicitly define an image for a page use following syntax anywhere on the page
  ~~PAGEIMAGE:<imageid>~~

===== Configuration and Settings =====
==== Admin Configuration ====
^configuration ^ Desc ^ Default ^
| default_image | default image id | ''""''|
| height | height of the images | 70 |

===== Development =====

=== Change Log ===


[[https://travis-ci.org/lisps/pageimage|{{  https://travis-ci.org/lisps/pageimage.png?nocache|Build Status}}]]

{{rss>https://github.com/lisps/pageimage/commits/master.atom date}}


=== Known Bugs and Issues ===
https://github.com/lisps/pageimage/issues
=== ToDo/Wish List ===

===== FAQ =====

===== Discussion =====