Archived from the PD4ML v3 support forum (2009). For PD4ML v4 see PDF header and footer generation.

PDF page headers/footers definition options

PD4ML · 02 Jun 2009, 13:15
PD4ML provides 3 types of headers/footers.

  1. text-only
  2. html (PD4ML Pro)
  3. inline (PD4ML Pro)

The first 2 options are available by PD4ML Java API calls (or as JSP custom tags mapped to PD4ML API): i.e.
<pd4ml:footer> -> pd4ml.setPageFooter();

1. Text only (in such form can be used only in JSP):
<pd4ml:footer
    pageNumberTemplate="page $[page] of $[total]"
    titleAlignment="left"
    pageNumberAlignment="right"
    color="#008000"
    initialPageNumber="1"
    pagesToSkip="1"
    fontSize="14"
    areaHeight="18"/>

Java version:
PD4PageMark footer = new PD4PageMark();
footer.setPageNumberTemplate("page $[page] of $[total]");
footer.setTitleAlignment(PD4PageMark.LEFT_ALIGN);
footer.setPageNumberAlignment(PD4PageMark.RIGHT_ALIGN);
footer.setColor(new Color(0x008000));
footer.setInitialPageNumber(1);
footer.setPagesToSkip(1);
footer.setFontSize(14);
footer.setAreaHeight(18);	
pd4ml.setPageFooter(footer);



2. HTML formatted footer (in such form can be used only in JSP)

<pd4ml:footer areaHeight="-1">
<font color="red"><i>page $[page] of $[total]</i></font>
</pd4ml:footer>

Java version:
PD4PageMark footer = new PD4PageMark();
footer.setHtmlTemplate("<font color=\"red\"><i>page $[page] of $[total]</i></font>");
footer.setAreaHeight(-1);	
pd4ml.setPageFooter(footer);


areaHeight="-1" means "autocompute" there



3. The third option, inline footer, allows to define footer body in HTML/PHP document:

<pd4ml:page.footer>
footer: $[page] of $[total]
</pd4ml:page.footer>


The definition impacts all subsequent pages after the page, where the footer defined. A new appearance of the footer overrides previously defined one.
In order to define the footer for the first page, you need to place the definition immediately after <body> tag or before <html>.

Also you may explicitly define pages, where the footer needs to be applied:

<pd4ml:page.footer scope="1">
first page footer: $[page] of $[total]<br> <img src="img1.gif">
</pd4ml:page.footer>
<pd4ml:page.footer scope="2+">
footer: $[page] of $[total]<br>
<img src="img2.gif">
</pd4ml:page.footer>
<html>
<head>
...

The above defines different footers for the first page and for the rest of the pages (the second and others). Also "scope" understands "even", "odd" and "skiplast" modifiers. Example:

scope="2,5-10,even,skiplast"
spillo · 08 Nov 2009, 12:45
I'm evaluating your product to use in production at a customer site.
I tried to add headers and footers to pages with these definitions:

<pd4ml:page.header>
		<table>
			<tr>
				<td>
					<img src="images/logos/telco/TLCO_headerOff.JPG">
				</td>
			</tr>
		</table>
	</pd4ml:page.header>
	<pd4ml:page.footer>
	       <table>
			<tr>
				<td>
					<img src="images/logos/telco/TLCO_footerOff.JPG">
				</td>
			</tr>
		</table>
	</pd4ml:page.footer>

The header appears but the footer does not.
I'm using the latest version of the library (3.5.1). I already checked the images and verified they are correct.
Can you help me?
PD4ML · 11 Nov 2009, 13:55
First, try to make sure that it tries to render the footer: add border="1" to footer's <table> and ispect if the borders are in the PDF output.
spillo · 13 Nov 2009, 12:57
I tried adding border="1" to the table element. The footer does not print. What else can I do?
PD4ML · 13 Nov 2009, 13:05
How many pages has the resulting PDF document?
Does it print the footer on the second page?
spillo · 13 Nov 2009, 13:16
The document has tree pages. The header prints on every page correctly while the footer never prints.
Just in case, I can send you an example generated PDF and the HTML used.
PD4ML · 13 Nov 2009, 13:40
yes, please send it to support (at) pd4ml . com
Manikandan · 24 Aug 2011, 10:39
Hello,
Did you find the solution for footer issue mentioned?I am also facing the same problem.
PD4ML · 24 Aug 2011, 17:09
Please send the HTML source, Java code snippet (if any) and its resulting PDF to support pd4ml com.
Pacx · 04 Jul 2012, 16:34
I'm trying to insert a footer for only page 1.

Via API-call this can't be done, accordering to the reference.

So, only inline is the only option I see.

This is my code:
<pd4ml:page.footer scope="1" areaHeight="100">
<div style="position: relative; float:left; top: 10px; left: 590px; font-size: 16pt; font-weight: bold;">52008</div>
<div style="position: relative; float:left; top: 10px; left: 850px; font-size: 16pt; font-weight: bold;">20090001</div>
</pd4ml:page.footer>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
...

This part seems to be just ignorred. (page.header does work this way).

Is this a bug, or am I doing something wrong?