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

= Include another page in current page

== Description

This is another version of the IncludeMacro. It takes one mandatory item and two optional positional items. The mandatory item is the page name. The optional items are the class of the generated heading and the class of the div surrounding the included page. If the first positional item is missing, no heading will be generated. If the second is missing, no div will be generated.

=== Example 1

The contents of page "Foo" will be included in the page when the plugin is expanded:

{{{
[[IncludePages(Foo)]]
}}}

=== Example 2

The contents of page "Foo" will be included in the page. The title of the page will be included in a header div with the class "headclass" as follows:

{{{
[[IncludePages(Foo, headclass)]]
}}}

The generated html is then as follows:

{{{
<div>
   <div class="headclass">Foo</div>
     { contents of Foo }
</div>
}}}

=== Example 3

Contents of page "Foo" are included in the page with a header div with class "headclass", in a div with class "blockclass" as follows:

{{{
[[IncludePages(Foo, headclass, blockclass)]]
}}}

The generated html is then as follows:

{{{
<div class="blockclass">
   <div class="headclass">Foo</div>
     { contents of Foo }
</div> 
}}}

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Recent Changes

[[ChangeLog(includepagesplugin, 3)]]

== Author/Contributors

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