= PageListPlugin =

== Description ==

The PageListPlugin for Trac provides a wiki syntax extension to
create dynamic list of wiki names that match a specific string.

For example, 

    pagelist:HowTo

would list all the wiki pages that end with !HowTo.


== Bugs/Feature Requests == 

Existing bugs and feature requests for PageListPlugin are 
[report:9?COMPONENT=PageListPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=PageListPlugin&owner=pkropf new ticket].

== Download ==

Download the zipped source from [download:pagelistplugin here].

== Source ==

You can check out PageListPlugin from [http://trac-hacks.org/svn/pagelistplugin here] using Subversion, or [source:pagelistplugin browse the source] with Trac.

== Example ==

There are two forms available for using PageListPlugin. The first is as a
wiki syntax and the second is as request handler.

=== PageListPlugin Wiki Syntax ===

The basic syntax is:

    pagelist:text

where the occurance of text within a wiki name is used as the
selection criteria.

There are two simple extensions to match a prefix or suffix:

    pagelist:prefix:text

would match all wiki names that start with text.

    pagelist:suffix:text

would match all wiki names that end with text.

The match is case sensitive.


=== PageListPlugin Request Handler ===

The PageListPlugin also implements a request handler called
pagelist. This can be used in a URL in the form of:

  http://host/pagelist/text

This would create a page that lists the wiki names that contain text.

There are two simple extensions to match a prefix or suffix:

  http://host/pagelist/prefix/text

would match all wiki names that start with text.

  http://host/pagelist/suffix/text

would match all wiki names that end with text.

As with the wiki syntax, matching is case sensitive.


== Recent Changes ==

[[ChangeLog(pagelistplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:pkropf] [[BR]]
'''Contributors:'''