Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
updated readme
  • Loading branch information
goerdy authored Sep 17, 2023
1 parent 9d0d0a9 commit 9eaef24
Showing 1 changed file with 82 additions and 4 deletions.
86 changes: 82 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,91 @@
# PrintablePDFYearCalendar

This project provides a script that renders a Year Calendar on one A4 PDF page.
This project provides a script that renders a year calendar on a single page PDF file.

You can pass an two-dimensional Array [Month][Days] with Text and Color for each day of the Year.
# Features

The Output is highly customizable.
* highly customizeable
* text and color for each day seperatly
* multi language suport
* suports holidays (color highlightning)
* color highlighting for Saturday and Sunday (AFAIK that fits western and hebrew demands, if your culture needs other highlighting, let me know and i will add suport for this)

Under *GNU GPL v3*
# Usage

1. include mkCal.php in your project
2. create new pdf
3. call mkCal function

require('mkCal.php');

$pdf = new PDF('L','mm','A4');

$pdf->mkCal("Example Calendar", 2024 ,"en_US", $DaysTextArray, $DaysColorArray, $DaysHolidaysArray, "#AAAA00" ,"#FF0000", "#990000", "some customizeable footer text", "A4Landscape", "#0000FF");



## style

$locale [string] e.g. "en_US" or "de_DE" for correct display of month and days in your lanaguage

$highlightHolidays [string] contains the Hex color key for holiday highlighting

$highlightSunday [string] contains the Hex color key for sunday highlighting

$ighlightSaturday [string] contains the Hex color key for saturday highlighting

*$format* [string] "A4Landscape" NOT IMPLEMENTED YET

*$colorSceme* [string] "red/blue/green/yellow" NOT IMPLEMENTED YET



## Calendar content

$title [string] contains the printed title of the calendar.

$Year [int] contains the Year of the Calendar (used to calculate weekdays...)

$footer [string] contains the footer text you want to be displayed.

Function expects three 2-dimensional Arrays. Where the first index is the month and the second is the day.

$DaysTextArray [string] contains the text to display in each given Day

$DaysColorArray [string] contains the Hex color key for backgroud color of each given Day

$DaysHolidaysArray [boolean] specifies if the given day is an holiday


example:

$DaysTextArray[2][18]="goerdy";

//February the 18th displays "goerdy".


$DaysColorArray[2][18]="#FF0000";

//February the 18th has a red background.


$DaysHolidaysArray[3][17]="true";

//March the 17th is highlighted as holiday.


See well documented example.php for further information.

# Licence

*GNU GPL v3*

# Credits

Uses FPDF in version 1.86 http://www.fpdf.org/

unchanged used FPDF Files:

fpdf.php

/fonts/...

0 comments on commit 9eaef24

Please sign in to comment.