To use the Updaters, you will need to install the UpdateSupport product.
This can be downloaded from here, where you will also find some documentation.
See the README.TXT file in the Updaters folder of the Squishdot distribution for more help.

Upgrading to Squishdot 1.5.0

• Run the 1-4-x_1-5-0.py updater.

NB: Please make sure you upgrade to Squishdot 1.5.0 before upgrading to Zope 2.6.0!

Upgrading to Squishdot 1.4.0

• Run the 1-3-0_1-4-0.py updater.

• in the mail_html method of any Squishdot Sites, change:

<dtml-var absolute_url>/cancelNotify 

to

<dtml-var "aq_parent.absolute_url()">/cancelNotify 

<dtml-let msgstr=validatePosting

to

<dtml-let msgstr=validatePosting>   

Upgrading to Squishdot 1.3.0

• Run the 1-2-x_1-3-0.py updater.

• in the mail_html method of any Squishdot Sites, change:

<dtml-if summary><dtml-if "meta_type=='Article'">
 <dtml-var "html2text(_.string.join(summary,'\n'))">
</dtml-if></dtml-if>
<dtml-var "html2text(_.string.join(body,'\n'))">

to

<dtml-var plain_text>

• in the previewPosting method of any Squishdot Sites, change:

<dtml-unless skipvalid > 
<dtml-if "meta_type == 'Squishdot Site'">   
<dtml-let msgstr=validateArticle>   
<dtml-if msgstr>   
<dtml-return "showError(_.None,_,title='Data Missing',message=msgstr,action=REQUEST['URL1'] + ''/previewPosting'')" >   
</dtml-if>   
</dtml-let>   
<dtml-else>   
<dtml-let msgstr=validateComment>   
<dtml-if msgstr>   
<dtml-return "showError(_.None,_,title='Data Missing',message=msgstr,action=REQUEST['URL1'] + ''/previewPosting'')" >   
</dtml-if>   
</dtml-let>   
</dtml-if>   
</dtml-unless> 

to

<dtml-unless skipvalid > 
<dtml-let msgstr=validatePosting>   
<dtml-if "msgstr[1]">   
<dtml-return "showError(_.None,_,values=msgstr[0],title='Data Missing',
                 message=msgstr[1],action=REQUEST['URL1'] + '/previewPosting')" >   
</dtml-if>   
</dtml-let>   
</dtml-unless> 

• Replace any occurences of <dtml-var SCRIPT_NAME> with &dtml-site_url;. This is likely to be present in:

  • site_footer

  • posting_html

  • showSearchResults

  • searchForm

  • index_html

Upgrading to Squishdot 1.2.1

• Run the 1-1-0_1-2-0.py updater.

• in the index_html method of any Squishdot Sites, change:

<A href="<dtml-if relurl><dtml-var site_url ></dtml-if><dtml-var urlname url_quote>"><dtml-var name></A>

to

<A href="<dtml-if relurl><dtml-var site_url ></dtml-if><dtml-var urlname>"><dtml-var name></A>

• In the previewPosting method, change all occurences of
  "validateComment(this(),REQUEST=REQUEST)"
  to
  validateComment
  (NB: no quotes)

• In the previewPosting method, change all occurences of
  "validateArticle(this(),REQUEST=REQUEST)"
  to
  validateArticle
  (NB: no quotes)

• Change the second line of the validateComment method so it reads as follows:

<dtml-unless "REQUEST.encoding=='Plain'"> 

• Change the second line of the validateArticle method so it reads as follows:

<dtml-unless "REQUEST.encoding=='Plain'"> 

Upgrading to Squishdot 1.1.0

• Run the 1-0-0_1-1-0.py updater.

• In the previewPosting method, change all occurences of
  validateComment(REQUEST=REQUEST)
  to
  validateComment(this(),REQUEST=REQUEST)

• In the previewPosting method, change all occurences of
  validateArticle(REQUEST=REQUEST)
  to
  validateArticle(this(),REQUEST=REQUEST)

• Insert the following lines at the start of the validateComment method:

<dtml-unless "encoding=='Plain'"> 
 <dtml-in "['title','author','email','body']">
  <dtml-call "REQUEST.set(_['sequence-item'],html2safehtml(REQUEST.get(_['sequence-item'],'')))">
 </dtml-in>
</dtml-unless>

• Insert the following lines at the start of the validateArticle method:

<dtml-unless "encoding=='Plain'"> 
 <dtml-in "['title','author','email','summary','subject','dept','body']">
  <dtml-call "REQUEST.set(_['sequence-item'],html2safehtml(REQUEST.get(_['sequence-item'],'')))">
 </dtml-in>
</dtml-unless>

Upgrading to Squishdot 1.0.0

• Run the 0-7-x_1-0-0.py updater.

• Replace the contents of the mail_html dtml method with the contents of the following:

  • mail_html.

Upgrading to Squishdot 0.7.x

There's a small change you need to make in the following DTML methods of each pre-0.7.0 Squishdot Site object:

• posting_html

• previewPosting

• addPostingForm

Whenever the expression <dtml-var expr="thread[0]" > occurs, you need to replace it with <dtml-var expr="getThread(0)" >

If you start getting KeyErrors on thread_path, it might be worth clicking on Re-Catalog All Postings on the Options manage tab.

Upgrading to Squishdot 0.6.0

Assuming you are upgrading from 0.5.0, there's nothing you need to do to old Squishdot Sites!

Upgrading to Squishdot 0.5.0

Assuming you are upgrading from 0.4.1, you don't need to do anything...

However, if you want to use the new Plain Text and Structured Text stuff, you'll need to change any exisiting Squishdot Sites you have as follows:

• Replace all occurence of

  <dtml-if body><dtml-in body><dtml-var sequence-item></dtml-in body></dtml-if body>

  (or similar such things)

  with

  <dtml-var showBody>

• Replace all occurence of

  <dtml-if summary><dtml-in summary><dtml-var sequence-item></dtml-in summary></dtml-if summary>

  (or similar such things)

  with

  <dtml-var showSummary>

• Add the following in the appropriate places on your addPostingForm method:

    <SELECT NAME="encoding">       
    <dtml-in "[['HTML','HTML'],['STX','Structured Text'],['Plain','Plain Text']]" >  
      <OPTION VALUE="<dtml-var "_.getitem('sequence-item',0)[0]" html_quote>" 
      <dtml-if "encoding==_.getitem('sequence-item',0)[0]">SELECTED</dtml-if>>
      <dtml-var "_.getitem('sequence-item',0)[1]" html_quote>
      </OPTION>
    </dtml-in>
    </SELECT>

• Add the following in the appropriate places on your previewPosting method:

    <SELECT NAME="encoding">       
     <dtml-in "[['HTML','HTML'],['STX','Structured Text'],['Plain','Plain Text']]" >  
       <OPTION VALUE="<dtml-var "_.getitem('sequence-item',0)[0]" html_quote>" 
       <dtml-if "REQUEST.get('encoding','HTML')==_.getitem('sequence-item',0)[0]">SELECTED</dtml-if>>
       <dtml-var "_.getitem('sequence-item',0)[1]" html_quote>
       </OPTION>
     </dtml-in>
    </SELECT>

• Finally, add the following to the form in the showError method:

  <INPUT TYPE="HIDDEN" NAME="encoding" VALUE="<dtml-var "REQUEST['encoding']" html_quote missing>">

Upgrading to Squishdot 0.4.1

Assuming you are upgrading from 0.4.0, please do the following for each of your Squishdot objects:

• change the two calls to showError in the previewPosting dtml method so they start start "showError(_.None,_,title" instead of "showError(REQUEST=REQUEST,title".

• you may also wish to create a new Plain demo site and copy mail_html and addPostingForm to replace those in any Squishdot objects created by a pre-0.4.1 version of Squishdot.

Upgrading to Squishdot 0.4.0

If you are upgrading from a previous version of Squishdot to 0.4.0, please do the following for each of your Squishdot objects:

• Rename the searchResults dtml method to showSearchResults.

• In the Postings management tab, click on Update Indexing.

• As an alternative to the above two steps, use the 0-3-x_0-4-x.py updater

• Replace the contents of the mail_html dtml method with the contents of either of the following:

  • Plain text mail notification.

  • MIME encoded mail notifcation.