[Phpwebsite-developers] Module Display Question

[Dwight F. <dw...@op...>]

I'm *very* new to phpwebsite, but am impressed. I am trying to learn how
to write a module .. and get it displayed on the main page. Much like
the Calendar module I want it to sit off in it's own little box with it's
own little display. What I want to do is be able to upload club newsletters
(PDF files) to the web server and then have a module that will make the
latest newsletter available on the main page. I also want to have a link
that will bring up another (larger) page that lists all newsletters in
date order.

Finally, I know I could do much of this with some simple blocks that are
edited each time a new newsletter is available, but I want to be able to
have this all work without having to change any code. In other words, I
want to just upload the latest newsletter (following some standard naming
conventions) and have the "Right Thing (tm)" be done.

I already have the PHP code in place to sort through the list of newsletter
files and, using their names, create the desired list. This was done for
another home-brew PHP based site .. the site I would really like to switch
over to using PHPWebSite. I just need to (a) wrap this behavior up in a
module and (b) present it on the site.

I already have worked over the "Skeleton" module to create a "Newsletter"
module, and have gotten it to install and run. It still just has the stock
standard skeleton code in it .. but with new names. I intend to adjust that
code to include my newsletter functionality once I have the basics understood.

What isn't clear to me is how a module (like Calendar) gets presented in
it's own box on the main page. Can someone clear this up for me? If this is
a FAQ and I should go RTFM, I'm happy to do so. Just tell me the FM to go R
and I'm off and running. I've searched, though, and have yet to find anything
that clears this up for me. :)

  -- Dwight (PHPWebSite newbie)