Zwiki

=======================

A "bugfix-plus" release, for IssueNo0385 (missing permissions).

* finish the switch to modern security declarations, fixing
IssueNo0385 and hopefully not breaking much else.

* also send mailouts on page deletion and renaming

=======================

Bugfixes, more solid CMF & Plone support, wikimail enhancements,
skins re-organization.

**Upgrade notes**

If you have mailin set up and find replies going to the default page
instead of the originating page, see IssueNo0376.

**CMF**

* rename CMFInstall.py to cmf_install_zwiki.py

* CMF skin support. zwiki_cmf is a lightweight CMF skin for zwiki;
zwiki_orig is a CMF skin that looks like zwiki's standard UI

* fix edit permission in CMF (IssueNo0366)

* fix a timezones error when in CMF

* make wiki folder & page management work in cmf/plone

* catalog lookup changed: look for a CMF portal_catalog;
look for SITE_CATALOG on page and containing folder only

* when creating a Wiki Page in CMF, allow the standard_page_type
folder property to control it's page_type.

* hide user options when in CMF

**Mail**

* look up destination page in the recipient's real name (first);
mailouts will encode the source page in the reply-to's real name.
This should make addressing and replying more natural.

* allow subject headings in mail and web comments. (To set the subject
from a web comment, use an initial one-line paragraph that is bold
(using '** or < b>') and no longer than 100 characters.)
Subjects are saved as edit log note and vice versa.

* generate a mailout when pages are created

* mailin page creation fixes

* mailin: handle freeform page names

* mailin: work even when default page is not found, as long as
there's at least one wiki page in the folder.

* mailin: add some failure logging

* look for 'mailin_policy' property instead of 'posting_policy';
the latter is still supported but deprecated

* don't use < hr> in comment headings

**Skins and wiki content**

* clean out & reorganize templates and default content under
skins, content

* new unified RecentChanges implementation; use SITE_CATALOG,
remove hard-coded zwiki.org

**General**

* wiki links to pages with accented names (and freeform names in
general if standard_error_message is not present ?) were not working

* parent wiki links were generating an error

* workaround for zope 2.6 stx+dtml breakage (IssueNo0270)

* fix for "some permissions had errors" (IssueNo0358)

* fix title changing in ZMI Edit tab (IssueNo0280)

* increase the added and removed lines truncation limits for diffs
and mailouts (to 200 and 20 lines respectively)

* ZWikiPage class initialization fix; fixes an event log file
warning (and.. ?)

* auto-upgrade WikiForNow pages

* log messages at BLATHER priority instead of DEBUG, and don't
require the Z_DEBUG_MODE or ZWIKI_DEBUG variable any more

=======================

* subscription now accepts CMF member usernames as well as email
addresses

* add zwiki web, add zwiki page forms internationalized;
.po files & spanish translation updated (JuanDavidIbanez)

* preliminary fit (framework for interactive testing) support
('dtmlfithtml' & 'stxdtmlfithtml' page types)

* allow a 'mail_subject_prefix' folder property to override the
folder title for mailout subjects. Useful when mailout subject and
cmf's "you are here" must differ.

* self.ZopeTime didn't work on a page in a CMF site, now does

* apply the stx initial-word-becomes-bullet workaround for all
zope versions

* support for auto-upgrading wikifornow pages

* minor default ui & content tweaks

=======================

Bugfixes, international page names, edit log notes, WikiForNow
assimilation completed, CMFWiki integration (alpha).

**Upgrade notes**

See Regexps.py for notes on configuring international page names.
When running large & extensively cataloged wikis, you might notice
this version being more memory intensive than 0.10 (which itself may
be more memory hungry than 0.9.9). This release should coexist with
CMFWiki without problems. Otherwise the usual, see
http://zwiki.org/TenMinuteZwikiUpgradeGuide &
http://zwiki.org/HowToUpgradeZwiki for more.

**Misc**

* better support for (single-byte) international characters in
page names & ids; enable out of the box, with or without a locale
set up (IssueNo0257)

* merge CMF support into standard ZWiki pages. See
Extensions/CMFInstall.py. (alpha)
(CMFWiki) (ChrisMcDonough)

* locking fixes for external editor support (CaseyDuncan)

* save an optional log note with edit (or type change, file
upload, ftp PUT, page creation, deletion (via DeleteMe))
(WikiForNow) (KenManheimer)

* allow page type to be set via FTP (WikiForNow)

* Don't allow completely anonymous invocations of rename/delete
(IssueNo0235)

* reindex after renaming

* set "FTP access" permission, send manage_edit through wiki
editing code the way WikiForNow does (IssueNo0243)

* a couple of compatibility tweaks for running inside a CMF/plone
instance - provide view & SearchableText methods, use
portal_catalog if present, don't use rule in comment headings.

**Default UI & wiki content**

* custom wikipage template was being called with the wrong context
(IssueNo0225)

* custom standard_wiki_header/footer methods were being ignored
(IssueNo0228)

* provide a traceback in html source when header or footer
rendering fails

* standard_error_message: fix missing "; make it work when not in
site's root folder (IssueNo0250)

* editform: move options down a row to handle long page names
better; fix tab ordering

* display last log note in history link title in header and at top
left when diff browsing; use a form button to return from diff
browsing

* use ZMI widgets for page_type and NOT_CATALOGED (WikiForNow)

**Rendering**

* new "text + links" page type

* wwml: some rendering fixes and convert spaces to tabs, described
on ConvertSpacesToTabs (PeterMerel)

* use new rendering code for issue pages (IssueNo0252,IssueNo0253)

* enable stx bullet workaround for all zope versions (IssueNo0273)

**Mail**

* filter blank items from mailout recipients (IssueNo0221)

**Compatibility**

* be more robust when upgrading timestamps (IssueNo0222)

* be more robust with older zopes which may not have page
templates (IssueNo0224)

* don't use prefix tag in add zwiki web form for compatiblity with
old zopes (IssueNo0229)

* be more robust reading version.txt.. zope-cvs doesn't have one
(IssueNo0254)

* fixprops.py utility method for fixing up zwiki page properties

**API changes (summary)**

Nothing major.

=======================

Pre-rendering for better performance, new freeform page names and
fuzzy linking, WikiForNow regulations support (beta), page renaming &
deleting, UI enhancement & simplification, better upgradability, page
templates support, i18n started, many bugfixes & minor enhancements.

**Upgrade notes**

This release has renamed page types and a new render-caching
mechanism, to which pages are upgraded automatically; full-featured
UI defaults which will be used if you delete your custom DTML
methods; and one new and one renamed permission. See
http://zwiki.org/TenMinuteZwikiUpgradeGuide &
http://zwiki.org/HowToUpgradeZwiki for more.

**Default UI**

* made built-in defaults full-featured (equivalent to current
zwiki.org UI).

* when adding a zwiki web, don't instantiate dtml methods, rely on
the built-in defaults instead

* support page templates as well as dtml methods for editform,
subscribeform, backlinks and for main page layout (a page template
named wikipage will take precedence over standard_wiki_header &
standard_wiki_footer dtml methods). The page body is passed to in
wikipage as options/body. The following additional options are
passed to editform: page, text, action, id, oldid.

* built-in defaults are now read from the filesystem. Defaults
for standard_wiki_header/standard_wiki_footer are still provided
but no longer quite as up-to-date and probably will be deprecated.

* consistent api for accessing UI methods/templates/defaults

* many UI updates and simplifications in default page layout,
editform, backlinks etc.; made UI options more flexible & robust

* full/simple/minimal display modes; simple (no page hierarchy) is
displayed by default

* retired jumpsearch (make the search box always do a simple
search)

* added tooltips & access keys to most links & form elements

* display a convenient page rename/reparent/delete form in the
footer in full mode if the user has a username (and permissions)

* external editor support

* make backlinks dtml more robust (IssueNo0210); fixed a case
where the parent checkbox didn't show up; now uses a catalog if
available to provide accurate fuzzy backlinks

* upload permission was incorrect in editform (IssueNo0178)

* removed "Show advanced edit form" option

* ensure comment form depends solely on Add comments permission

* fix white space in center of footer in NS 4.7

* don't show "sp" for spacer image in text-mode browsers

* a missing slash caused edits to fail in netscape 4.7

* added secret AnnoyingQuote edit link

* better support for web robots - removed robot-excluding meta tag
from standard_wiki_header/wikipage, added robot exclusion tag to
editform/subscribeform/backlinks; use form buttons instead of
links to keep robots out of page history etc.

**Default zwikidotorg content**

* fewer pages

* new FrontPage

* new HelpPage

* updated RecentChanges, uses catalog if available

* updated SearchPage with selected extra search tools

* cleaned up UserOptions

* provide a list of timezones, MoinMoin style
(IssueNo00146)

* a standard_error_message method handles nonexistent urls,
with fuzzy and partial matching on page names

* minor text cleanups in default editform & zwikidotorg content


**Rendering**

* Pre-rendering support: new page types (used by default) process
text formatting rules and wiki linking rules once at edit time.
This makes rendering of large pages much faster (possibly at the
expense of quicker zodb growth). Also allows us to accurately
catalog links.

* Better freeform page names - square brackets now allow almost
any page name, not just those with url- and zope-id-safe
characters. Freeform names are converted to wikiname-like page ids
and either may be used for linking, supporting co-existence of
freeform and wikiname pages.

* Fuzzy linking - square brackets also do fuzzy linking, ignoring
whitespace and capitalization.

* square brackets now link only to zwiki pages, not other zope
objects or url paths

* Wiki links now have title attributes/tooltips displaying the
target's age and last editor when you mouse over (except for
freeform page names in contents hierarchy and parent context)

* support for simple sub wikis/WikiAcquisition - wikilink targets
can be acquired from the parent folder (or above) and are
displayed with ../ prepended

* don't link WikiNames inside structured text links (IssueNo0190)
or the content of html anchor tags (IssueNo0194)

* allow stx tables to have + at the corners

* the RemoteWikiURL tag is now case-insensitive

* make accidental structured text footnote processing less likely;
use more standards-compliant "ref" prefix for footnotes, like newer stx

* don't treat a bare url followed by : as a remote wiki link

* make stx links work in non-html stx modes (IssueNo0193)

* fix for IssueNo0186 (page rendering fails if it contains a
freeform link containing unbalanced parentheses)

* added (?L) to the regexps which use \w or \b to make them
locale-sensitive. (EdwardKreis, AlexyKhrabrov,
InternationalCharsInRegexps)

* display "you are here" in page hierarchy

**Editing**

* strip HTML header & footer found in edit text

* make post-stx HTML & BODY tag stripping more robust (EdwardKreis)

* check for a webdav lock before saving an edit or entering editform

* don't highlight the last edit access key if it's not hyperlinked

* allow existing files to be re-uploaded (IssueNo0006)

* don't add a link for uploaded files if the page already has one

* set last_editor properly during mailin (IssueNo0207)

* recatalog pages after ftp/http/webdav put

* abandon the old antidecap kludge

**Mail**

* fixed the multiple subscription bug (IssueNo0161)

* fixed page creation

* make mailin tracker issue creation more robust

* mailin in the context of a zwiki page was not working as
advertised

* include standard mailing list headers in mailouts

* discard all mail that appears to come from a bot, and the common
"out of office" auto responder replies

* post comments/create pages using the sender's real name or just the
username component from their email address, not the full address
(IssueNo0066, PieterB/SM)

* fixed a bug in upgradeSubscribers which caused folder properties
to proliferate

**Tracker**

* added a createIssue method which can replace the AddIssue &
IssuePrototype pages

* increased title's max length from 100 to 200 when editing issues

* when rendering the issue form, generate option menus dynamically
from the issue_* properties (MikeFair)

**Compatibility**

* better auto-upgrading & backwards compatibility; allow
auto-upgrading to be disabled via flag in Defaults.py;
new upgradeAll method for batch upgrading & re-rendering

* removed STletters dependency for older zopes

* don't pass stx header argument with zope 2.4.0 (IssueNo0152,
TrevorToenjes)

* added zope 2.5.1 to list of zope versions for unit testing

* improved python1.5 support

* improved zope version checking

**Misc**

* support WikiForNow-style regulations if use_regulations boolean
folder property is true

* add support for page renaming/deleting

* tweak allowed suffixes for fs-based wiki templates

* add more informative transaction notes

* ZWikiPage.manage_changeProperties was non-functional

* fix ZMI add zwiki page (IssueNo0187), make it equivalent to wiki
page creation

* spanish translation of initial i18n strings (J. David IbÃ�¡ÂÃ�±ez)

* canadian french translation of initial i18n strings (JoannePlouffe)

* the beginnings of i18n support, using Localizer if installed. A
few strings (edit conflict, authentication errors) internationalized.

* use last_edit_time everywhere in preference to
bobobase_modification_time

* debug logging of zwiki catalog operations (if Z_DEBUG_MODE or
ZWIKI_DEBUG variables are true and STUPID_LOG_SEVERITY is <= -200)

**API changes (summary)**

* wikimail/editform/subscribeform/backlinks page templates will be
used in preference to standard_wiki_header/standard_wiki_footer/
editform/subscribeform/backlinks DTML methods. The page body is
passed to wikipage as options/body. These options are passed to
editform: page, text, action, id, oldid.

* page types renamed. Here is the current list of page types (see
AllAboutPageTypes for details)::

stxprelinkdtmlhtml
stxdtmllinkhtml
dtmlstxlinkhtml
stxprelinkhtml
stxlinkhtml
stxprelink
stxlink
wwmlprelink
wwmllink
prelinkdtmlhtml
dtmllinkhtml
prelinkhtml
linkhtml
dtmlhtml
html
plaintext

* the RemoteWikiURL tag is case-insensitive

* the OFS.ObjectManager.bad_id definition is used as the basis for
generating page ids

* some properties are now looked up by containment rather than
acquisition context, eg subscriber lists

**ADDED::**

'Zwiki: Rename pages' permission
use_regulations folder property
zwiki_displaymode cookie
ZWIKI_DEBUG environment variable
addStandardLayoutTo
age
applyLineEscapesIn
asAgeString
backlinks
canonicalId
canonicalLinks
canonicalLinks
changeIssueProperties
createIssue
creationTime
editform
folder
htmlunquote
isMailoutEnabled
isZwikiPage
lastEditInterval
lastEditTime
linkTitle
linkTitleFrom
offspringAsList
offspringIdsAsList
pageWithFuzzyName
pageWithName
pageWithNameOrId
relative_urls
renderLinksIn
standard_wiki_footer
standard_wiki_header
stxToHtml
subscribeform
upgradeAll
urlunquote
wikipage

**CHANGED::**

'Zwiki: Recycle pages' permission -> 'Zwiki: Delete pages'
creation_time and last_edit_time are now ISO-format strings
doLegacyFixups -> upgrade

**REMOVED::**

zwiki_advancededit cookie

======================

Focus: unit tests, wikimail enhancements, general fixes and a
permissions rename.

**Upgrade notes**

You'll need to make a note of your zwiki permissions settings before
upgrading and recreate them after this upgrade. You'll find all the
new permissions at the bottom of the security page, aside from the
Add permissions which are unchanged. Also you may have dtml which
checks for the old permissions and needs to be updated. For example,
the wiki templates refer to the permissions by name in
standard_wiki_header, standard_wiki_footer and editform.

**Features**

* zwiki permissions renamed. Details::

'Add ZWiki Pages' (no change)
'Add ZWiki Webs' (no change)
'Zwiki: Add comments to pages' (was Append to ZWiki Pages)
'Zwiki: Change page types' (was Change ZWiki Page Types)
'Zwiki: Edit pages' (was Change ZWiki Pages)
'Zwiki: Reparent pages' (was Reparent ZWiki Pages)
'Zwiki: Recycle pages' (was Send ZWiki Pages to Recycle Bin)

Zwiki also uses zope's 'Add Documents, Images, and Files' (no change)

* zwiki page 'subscribers' property replaced by 'subscriber_list'
property; the folder also now exposes this in the ZMI. Upgrade
notes: old pages will be upgraded as needed, this will affect
the last-modified times.

* new zwiki page properties: 'creator', 'creator_ip', and
'creation_time'

* a 'redirectURL' REQUEST attribute can be used to control the
destination after edit, append or comment.

* the enclosing [] are displayed prior to page creation

* relative paths within [] now display in their entirety
(instead of just the last component)

* UI and usability tweaks for the default subscription form;
other page subscriptions are listed

* the folder title is now used in html page titles, in mailout
subjects and before the word "contents" in the page header. The
old titleprefix method is no longer used.

* wikimail: only comments (made via the "comment" method) are now
mailed out by default; to mail out all edits as before, set a
'mailout_policy' folder property to "edits".

* wikimail: hide mailout recipients (if Lennart Regebro's
MailHostFix product is installed)

* wikimail: mailout now requires either a 'mail_from' or
'mail_replyto' folder property. If 'mail_from' is present, always
use that for the From: field. Otherwise, show the poster's email
address or user name. (closes IssueNo0122)

* wikimail: increase wrap margin from 70 to 78 in mailouts

* wikimail: add X-Zwiki-Version, X-BeenThere & Precedence headers

* wikimail: basic loop protection - silently discard any incoming
messages containing X-Zwiki-Version

* wikimail: mailin can now create pages (JosYule)

* wikimail: mailin can create tracker issues (see mailin.py)

* wikimail: mailin.py now accepts mail only from subscribers
(somewhere in the wiki) by default. Call with 'subscribersonly=0'
or set folder property 'posting_policy' to "open" to disable.

* wikimail: the default destination page for mailin can be
configured with a 'default_page' folder property

* wikimail: use only the first plaintext part from multipart MIME
messages

* wikimail: use virtual host monster to help direct messages if
present (may have some imeme-isms ?)

* wikimail: some other tweaks to mailin delivery rules intended
to simplify mailin alias setup (see mailin.py)

* zwikidotorg template: header/footer/editform UI updates; display
subscriber count in the header; set comment headings on by default
for pages named "IssueNo*"

* zwikidotorg template: for site logo, use the folder's
'site_logo' property/object or the default zwiki icon.

* add zwiki web form: made this a little more robust; added
support for template configuration wizards (if a form or script
named TEMPLATE_config is found, redirect there to create the wiki)


**Bug fixes**

* DeleteMe should redirect to the first existing parent
afterwards, now working again (IssueNo0008)

* zwiki now coexists with structured text footnote references
(yay!). [] will link to a matching footnote if there is one,
otherwise it is treated as a wiki link (IssueNo0110)

* don't treat [] as wiki links if they contain characters which
zope does not allow in object ids (IssueNo0090)

* don't html-quote international characters any more. If losing
international characters due to edits by dumb browsers is now a
problem for you, please follow up on IssueNo0004.
(Taewook Kang & others)

* make wikiname regular expressions a bit more international by
using string.upper/lowercase. You may need to modify bad_id in
zope's OFS/ObjectManager.py also.
(LaloMartins, Alexy Khrabrov)

* fix for IssueNo0112, structured text pages have extra html &
body tags (natesain)

* parenting tweaked to work better with acquisition/subfolders
(IssueNo0108) (robertredcor.ch)

* wikimail: stray html tags were being left in mailouts containing
long quoted lines (IssueNo0087)

* wikimail: don't add extra blank lines in mailouts

* wikimail: don't send duplicates when subscribed to both page and
wiki (IssueNo0055)

* wikimail: calling mailin in the context of a page should always
use that page for posting, now it does

* wikimail: format quoted replies in mailed-in tracker issues,
as is done with mailed-in comments (IssueNo0070)

* zwikidotorg template & general: edit access control ui
improvements. Help/subscribe links now always visible;
edit/append links conditionally visible; viewing editform requires
edit permission; misc. color & layout tweaks.

* zwikidotorg template: fix scrolling to bottom of page after
comment

* zwikidotorg template: don't include "set" links on backlinks,
because they are vulnerable to robots

* zwikidotorg template: show search and quote in header by default
again

* zwikidotorg template: removed the "preferred front page" option
(IssueNo0120)

* zwikidotorg template: adding an empty comment was giving an error
(IssueNo0123)

* tracker support: issuedtml page type: layout & colour scheme tweaks

* tracker support: allow sorting by category/severity/status to
give the expected order (see IssueNo0115)

* tracker support: don't list other page types when editing an issue page

* tracker support: don't inherit issuedtml page type when creating
a new page from an issue page

* Possibly fixed a bug with Add Zwiki Page permission.

* unit tests overhauled, cleaned out and updated. Zwiki now
follows the latest zope testing practices.

* zwikidotorg template: remove references to old permissions

* recognize , in urls (IssueNo0130)

* zwikidotorg template: remove comment form border

* fix bracketed path linking (IssueNo0139)

* missed some old-style imports in the subscription code

* zwikidotorg template: UserOptions tweaks - make default editform
dimensions match built-in default (60x15); don't use PST as
default timezone

* zwikidotorg template: make timezone conversion in the header
more robust

* remove a local PYTHONPATH dependency from all imports, and
make unit tests more robust across zope versions & invocation
methods

* wikimail: multipart message handling got broken in the cleanup,
fixed

* wikimail: make inclusion of poster's username in mailout From
header more robust

* zwikidotorg template: removed SiteLogo capability & obsolete
zwiki_homepage reference, added secret feature for minimalists.

* render page header *after* body, so that body can turn it off
with dtml

* make create more robust for dtml use in a top-level folder

* built-in ui tweaks - use colours like zwikidotorg's, make
editform textarea smaller, remove non-useful help links

* zwikidotorg template: include user option presets in the footer,
make help link depend on a HelpPage, update default bookmarks

**API changes (summary)**

* permissions renamed (see above)

* viewing editform() now requires edit permission

* 'subscriber_list' page property replaces 'subscribers'

* new page properties: 'creator', 'creator_ip', 'creation_time'

* new optional folder (or page) property: 'mailout_policy'

* new optional folder properties: 'mail_replyto',
'posting_policy', 'default_page'

* 'titleprefix' property/method no longer used, folder title used
instead

* new optional REQUEST attribute: 'redirectURL'

* sendMailTo() now takes a list of recipients, not a string

* subscriberList(), wikiSubscriberList(), allSubscribers() now
return a list

* new page methods: allSubscriptionsFor(email),
otherPageSubscriptionsFor(email)

* zwiki_mailin.py external method renamed to mailin.py

* new mailin() arguments: 'subscribersonly', 'trackerissue'

* wikis subdirectory renamed to templates, and filesystem
templates now use suffix to specify zope meta_type/zwiki page_type

* zwikidotorg template: new optional folder property 'site_logo'

* tracker support: new page methods: category_index(),
severity_index(), status_index()

* new page method zwiki_version()