[[PageOutline(2-5,Contents,pullout)]]

= Random Includes and Random Quotes (Fortune Cookies)

== Description

These are Trac wiki macros to pick a random selection or selections from a page that contains bulleted items.

RandomInclude includes some number of bulleted items on that page. The purpose of this macro is to display a sample of pages from your wiki.

RandomQuote includes one random item from that page, and strips the bullet from it. It is used to include a changing fortune cookie on a page.

Find 10 bulleted (*) items on RandomPage and include those items in the current page:

{{{
[[RandomItem(RandomPage,10)]]
}}}

Display a (pseudo-)randomly chosen quote from a source page "Fortune Cookies":

{{{
[[RandomQuote]]
}}}

Display a quote from QuotePage:

{{{
[[RandomQuote(QuotePage]]
}}}

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=RandomIncludePlugin new ticket].

[[TicketQuery(component=RandomIncludePlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:randomincludeplugin here].

== Source

You can check out RandomIncludePlugin from [/svn/randomincludeplugin here] using Subversion, or [source:randomincludeplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(randomincludeplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:Rottenchester] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''