blog_index.cgi - A simple blog-style view of your archived list messages

NAME

blog_index.cgi - A simple blog-style view of your list's archived messages

DESCRIPTION

This small extension script prints out the last, x archived messages, in a blog-style fashion, with the text of all the archived messages shown on one screen. You can then embed this into a page you may have on your site, either by calling the extension like a Javascript library, or calling it as an old-school Apache Server Side Include.

In a pinch, you can then use Dada Mail in a more blog-like manner, by creating new entries to your Dada Mail-powered blog by creating new archive messages:

In Dada Mail's, "Send a Message" screen, there's a fieldset labeled, Archive Options. Expanding this fieldset will reveal options to, Archive, but DO NOT Send the message you're creating and also an option to Backdate the entry. This will allow you to add new entries to your list's archives, without having to send the messages out to your subscribers.

One thing I find useful is to have my blog powered by Dada Mail: I can make new entries more frequently, but just archive and not sending - much more frequently than I feel comfortable sending to my entire list, but have all the entries available on my blog. That way, my mailing list gets the more important messages sent and if I want to get a bit chatty, I can, without deluging my list with messages they may not want to have fill up their inbox.

This simple extension does not support some of the more familiar blog-like things, such as commenting on an entry, but does provide other features. Since Dada Mail already supports RSS/Atom feeds for its archived messages, your blog powered by Dada Mail does as well. The core of Dada Mail also supports full text searching of archived messages.

For a simple site where a blog is just one part of the entire site, such simplicity may be all you really need.

USAGE

Use it like a CGI script.

Put it in your, extensions directory (ala: cgi-bin/dada/extensions), chmod 755, visit it in your web browser.

As a Javascript Library

To add this form to your HTML page, just add a line that looks like this:

        <script type="text/javascript" src="http://example.com/cgi-bin/dada/extensions/blog_index.cgi"></script> 

Where, http://example.com/cgi-bin/dada/extensions/blog_index.cgi is the URL to this extension.

As a Server Side Include

You can also call it as a server side include, like this:

  <!--#include virtual="/cgi-bin/dada/blog_index?mode=html" -->

Make sure to add the query string, mode=html

By Itself

Not really a method, but you can view the HTML and Javascript produced by visiting the extension in your web browser, with the same query string you use for the Server Side Include:

http://example.com/cgi-bin/dada/blog_index.cgi?mode=html

By Copying the HTML/Javascript

You could also try just copying the source that this script produces from the URL above, and paste it into a page/script/etc that you'd like.

Probably not the best idea, but I'll throw that idea for ya.

CONFIGURATION

There's no configuration that you are required to do, but there's many things that you can do. We'll try to cover everything:

$Plugin_Config->{Default_List}

This extension currently shows one list's archives at one time - there's no collating of archive entries from different lists, or anything.

The, Default_List config variable holds what the default list can be. Set it to a list's shortname:

 $Plugin_Config->{Default_List}  = 'mylistshortname';

If no list is set, you will need to tack on a query string to the end of the script, when you call it:

 http://example.com/cgi-bin/dada/extensions/blog_index.cgi?list=mylistshortname

In this example, mylistshortname is your list's shortname and:

 ?list=mylistshortname

Is the entire query string you'll have to tack on.

If you've configured this variable incorrectly, you'll most likely receive an error in your web browser, so take care in setting it correctly.

DIAGNOSTICS

None, really.

CONFIGURATION AND ENVIRONMENT

There are a few variables at the top of the script that will need to be changed. They are:

SEE ALSO

Dada Mail also can share its archives using its built-in RSS/Atom feeds. In your list control panel, go to:

Manage Archive - Archive Options - Advanced

DEPENDENCIES

INCOMPATIBILITIES

BUGS AND LIMITATIONS

Currently, this extension is simple, and only handles one list at a time.

If this extension becomes popular, I may give it the capability to handle all lists and at the same time, as well as have some of the more interesting archive capabilities support (embedded attachments, etc)

Please, let me know if you find any bugs.

AUTHOR

Justin Simoni

See: https://dadamailproject.com/contact

LICENSE AND COPYRIGHT

Copyright (c) 1999 - 2023 Justin Simoni All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


Dada Mail Project

Download

Installation

Support