Saké
Mail Template Modifications
We maintain this document so that you can see what
specific changes have been made to the Saké Mail template structure,
so that you can update your templates when you are updating your
installation to a new version.
Revision History:
This section describes the new changes for each version of the
software so that you can tell if the changes are worth going through
the trouble of downloading.
Saké
Mail, version 1.0.27
Monday, July 24, 2000
Added the "t_sendconfirm"
template. If you would like your users to have the ability to
toggle the setting to provide them with a send confirmation page
when they send messages, then include the option as shown in the
"t_options_general" template,
and add the "t_sendconfirm"
template to your skin. This is completely optional, if you do
not add the option or the new template, then Saké
Mail will simply act as though the feature was never implemented.
Saké Mail, version 1.0.24
Monday, July 24, 2000
This is the first release with an "External Accounts"
feature. Two new templates have been added, "t_accounts"
and "t_account". There are
also five new snippets in the "t_f_messagelist"
and "t_nf_messagelist" templates,
which are used for reporting error messages from accessing external
accounts. Specifically, look at the snippets "EXTERNAL_NEW_IMAGE",
"ACCOUNT_ERROR", "AUTHENTICATION_FAILED",
"LOGIN_NOSERVER", and "LOGIN_NOCONNECT".
Finally, to enable the new feature, add the snippet and keyword
to your "t_options" page.
Saké
Mail, version 1.0.22
Tuesday, June
28, 2000
In the default templates before verion 1.0.22, it is
possible to put Sake Mail into an inconsistent state that can
occasionally cause problems. If you are using the frames-based
interface and you click on a message to display it, then you use
the "delete marked" operation to delete the message,
the message will still be visible in the lower frame. You can
now trigger operations, such as "Reply", that will cause
errors, since the message no longer exists. This is a template
problem, not a Sake Mail problem. The problem is not apparent
when using the "Delete" button in the lower frame, since
that operation will cause a complete refresh of the entire frameset.
The solution is to modify the form used in the "t_f_messagelist"
template so that it targets the top frame. Do this by adding a
"target"
specification to the form header in "t_f_messagelist".
The form header should look like this:
<form method="post" action="%%ME%%"
target="%%TOPFRAME%%">
|
...then remove the hidden form tag in the style sheet
template specification for "messagelist_body"
in the "style.xsl" file.
Simply remove the following line:
<input type="hidden" name="target"
value="listframe"/>
|
The end result of all of this is that when you use
either the "Delete Marked" operation or the "Move
Marked" operation on the frames-based message list, the entire
frameset will refresh. This ensures that any messages that are
no long valid will not be displayed in the lower frame.
Saké
Mail, version 1.0.19
Friday, May
19, 2000
The XML/XSL template processor has been updated to
the latest XSLT specifications, documented at http://www.w3.org/TR/1999/REC-xslt-19991116.
This allows for some extra functionality that you couldn't do
before with our old templates, and it ensures that the XSL that
we use is really the 'official' XSL. The bad news is that the
W3C has slightly changed the specification since the last release,
and style sheets built to the old specification will no longer
produce viable output. It's a really simple fix though. Just update
your "style.xsl" file to
the new header from the example in the "default"
skin. Remember to do this for every skin that you are using, specifically
don't forget your WML skin. The header for your HTML style sheets
should look something like:
<?xml version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" /> |
...and the header for your WML style
sheets should look something like this:
<?xml version="1.0"?>
<xsl:stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" omit-xml-declaration="yes"
/> |
These style sheet changes do not affect
your installation if you are using HTML templates instead of
XML/XSL templates.
Also in 1.0.19, there are
now some new hidden form values in the "t_compose"
template that give an administrator some control over the character
set used to send messages. Without these settings, Saké Mail
is still smart enough to send most things using ISO-8859-1,
and to use UTF-8 for when ISO-8850-1 can't handle portions of
the content. You should only mess with the character set configuration
if you want mail to always be sent using a given character
set.
Saké Mail, version
1.0.18
Wednesday, May 03, 2000
The "Addresses" page
has been expanded to include public addresses as well as private
addresses. The public addresses are presumably fed from an LDAP
server. These changes do not affect your installation if you
have an existing "t_addresses"
template file unless you plan on using the public addresses
functionality. If you are planning on using the public addresses
functionality, then there are several new snippets that you
will need to add, take a look at the example in the "default"
skin for more details.
Also changed with version
1.0.18, Addresses and Folders now are paged, rather than simply
displayed in a flat fashion. This means that there are a few
additional paging snippets and keywords to add to the "t_addresses"
and "t_folders" templates.
Saké Mail, version 1.0.17
Wednesday, April 05, 2000
Added There is now potentially a "BCC" option for
sending blind carbon copies. If you want to include this functionality
in your installation then just copy the table row that produces
the "CC" line from the "t_compose"
template, and modify the setting from "CC" to "BCC".
Take a look at the example in the "default"
skin.
|