Accessibility

Contribute Release Notes

Macromedia Contribute 3 and Contribute Publishing Services Release Notes

About Contribute 3

Macromedia Contribute 3 redefines web publishing, making it an activity open to everybody, everyday. This release meets the full spectrum of needs for business users, web professionals, and IT decision makers. As a key element of the new enterprise-ready, scalable Macromedia Web Publishing System, Contribute 3 lets everyone in an organization publish to websites and bring them alive with up-to-date information. Contribute is part of the Web Publishing System, along with Contribute Publishing Services and Macromedia Studio MX 2004.

About Contribute Publishing Services

Contribute Publishing Services (CPS) provide central management of website connections and integration with Active Directory and LDAP user directories. CPS also includes a new web services-based notification system that enables server-side extension development and powers the ability to log events and notify administrators when users create or edit pages on a website. Contribute Publishing Services are part of the Web Publishing System, along with Contribute and Studio MX 2004.

About the Contribute 3.1 and Contribute Publishing Services 1.1 Updates

The Contribute 3.1 English Updater fixes several problems found with the English version of Contribute 3 after its release. The updater is available for Windows and Macintosh. The Contribute Publishing Services (CPS) 1.1 Updater fixes several problems found with the English version of CPS 1.0 after its release. CPS 1.1 also includes several new features.

System Requirements

Starting with the Contribute 3 release, Contribute no longer supports Macintosh OS 10.1 or early versions of 10.2. The Contribute Preview Release will not work on OS 10.2, but we expect to support that OS for the shipping version. For more information, see the Contribute system requirements on the Macromedia website.

Contribute Publishing Services system requirements are also on the Macromedia website.

What's New in Contribute 3

You can get a quick overview of what's new in Contribute 3. Also, be sure to check out the in-product tutorials and other resources for learning Contribute at the Contribute Developer Center. Find inspiration with tips, articles, tutorials, and resources, or steer your project to success with forums, code examples, exchanges, and reference materials.

Issues Resolved with the Contribute 3.1 English Update

Nested Connections

In past versions of Contribute, it was not possible to create connections to different levels of the same website. Contribute 3.1 allows you to create overlapping, or child, site connections (i.e. http://mysite and http://mysite/folder1). This allows administrators to delegate administration of parts of the website to other people within the organization. NOTE: Child sites do not inherit administrative settings from parent sites.

Streamlined File Publishing

In past versions of Contribute, the process of uploading non-HTML files (like images and Office Documents) directly to the server was confusing. Contribute 3.1 allows you to publish non-html pages from your computer directly to your website using the File Menu. For example, you can publish a Word document to a specific folder on your website, then link to it later if you wish. This enhancement removes several extra steps in publishing a non-html page to your website.

Replace File on Publish

In past versions of Contribute, you were not able to overwrite or replace a non-HTML file upon publish. Instead, Contribute would created a copy of the file with a modified name (i.e. Filename.doc and Filename_001.doc). Contribute 3.1 gives you the option to replace a non-html page on your website with a file from your computer. For example, if you need to update a PDF on your website, you can replace it by publishing a new version to the same location.

Lock breaking interface

In past versions of Contribute, the process of overriding another user's file checkout had to be done manually. With Contribute 3.1, an administrator can override a user's file checkout (break a lock) using a simple UI. This interface appears just below the Browser Address bar when you browse to a page that has been checked out. For example, if you need to edit a page but it is checked out by someone on vacation, an administrator can easily break the lock to make it available for editing again.

Insert Breeze content link

In past versions of Contribute, the process of linking to Breeze content required several steps. Contribute 3.1 can connect directly to a Breeze server, or content repository, so that users can create a link to Breeze content by using the Insert > Breeze Link menu option. For example, you can insert a link to a presentation or meeting stored on a Breeze server.

Guard Page creation override

In Contribute 3.1, administrators can manage a site even if a guard page cannot be found. This enables administrators to manage websites on servers that don't support index files or directory listings. NOTE: Creating a connection to a website without a known guard page poses some security risk and is not a recommended best practice.

FlashPaper uninstall

Contribute 3.1 allows you to uninstall FlashPaper using the following option: Start > Programs > Macromedia > Uninstall Macromedia FlashPaper 2. This allows users to uninstall FlashPaper but keep Contribute, if they so desire.

CPS maintenance improvements

In Contribute 3.0, some users became "stuck" when a CPS-managed website was copied from one server to another. In Contribute 3.1 it's easier to recover from situations like this, where the hub file doesn't match the actual server information.

Local draft warning

Contribute 3.1 warns users when they quit Contribute that any drafts they have checked out will not be accessible from another machine. This will help avoid confusion that drafts were stored on the server, rather than locally.

Key Fixes and Features in the Contribute Publishing Services 1.1 English Update

LDAP multiple branch support

CPS 1.1 supports adding users who are on different LDAP branches, including Distinguished Names (DNs) and Organizational Units (OUs). This enables different groups within an organization to connect to a single CPS server, regardless of their level in the LDAP tree.

LDAP Search customizations

Customers experiencing performance problems with their LDAP user searches can now optimize the way the CPS performs LDAP searches to work best with their system’s capability. Specifically, users can now specify the wildcard that is used to query the LDAP directory.

RSS Activity Feed service

CPS 1.1 now includes an activity feed service that receives Contribute event notifications and broadcasts them using RSS protocol. This allows website administrators to view website update notifications in their Blog Reader of choice. This service is in the form of a starter ColdFusion script, and can be extended to fit specific needs.

Server Log UI

CPS 1.1 now has an easy way to view a wide array of server logs from within the administration UI.

Simple File Deployment service

CPS 1.1 now includes a simple Publishing Service that can be configured to deploy files from a staging server to a production server. This service is in the form of a starter ColdFusion script, and can be extended to fit specific needs.

Maintenance improvements

CPS 1.1 allows you to delete sites through the CPS admin UI.

Known Issues

General

Please use a different user name in Contribute 3 than the one you use in Macromedia Dreamweaver. If you are using CPS to manage your sites, you may end up having the same username on multiple machines. In this case, use the "Send for Review" feature to send drafts from one machine to the other.

Please uninstall the Contribute 3 Preview Release completely before installing and running the shipping version of Contribute 3.

Using Contribute 2 and Contribute 3 or 3.1 Together

Contribute 2 and Contribute 3 or Contribute 3.1 can be used together to edit the same website, as long as "Transition Mode" is selected in the Contribute 3 or 3.1 Administer Website dialog box (in the Compatibility category). However, administrators who want to take advantage of all the new features available starting with Contribute 3 need to upgrade all users on a specific website to Contribute 3.1.

Upon connecting to the website for the first time with Contribute 3, all users should immediately walk through the Connection Wizard. Users do not need to make any changes to the existing settings --they just need to step through all the dialogs.

If the above steps are not taken, the Send For Review feature will not work properly for all users on the website.

Prior to migrating a site to use the Contribute Publishing Services, make sure all users on the site publish any drafts they have checked out.  If they fail to do so, they will need to do File > Export to save any changes made to the draft.

Using Contribute 3 and Contribute 3.1 Together

Contribute 3 and Contribute 3.1 can be used together to edit the same website.

Connection Keys

Contribute 3 and Contribute 3.1 connection keys will not work in Contribute 1 and Contribute 2. However, Contribute 1 and 2 connection keys will work in Contribute 3 and Contribute 3.1.

In Contribute 3 and 3.1, it is possible to send a user a connection key that contains a URL to Contribute Publishing Services. Unlike other connection keys, connection keys to Contribute Publishing Services do not contain the end user's connection information--it contains only the URL for your publishing services. Users who receive this type of connection key still need to authenticate.

Dreamweaver-related Issues

Dreamweaver Launch & Administer may not work on Macintosh OS X 10.3.5. When you choose to administer a Contribute site from within Dreamweaver, you get the following error message: " You must install Macromedia Contribute version 2.0 or later to administer a site. Would you like to install Contribute now?"  This message appears despite the fact that you have Contribute 3 installed.  The workaround has three steps:

  1. Copy your Contribute Application folder, and then delete the old folder.
  2. Rename the copied version to Contribute 3.
  3. Launch Contribute, and then immediately quit.

If you're running Mac 10.2.8 and have multiple versions of Contribute on your machine, the oldest Contribute build in the machine launches when you select Launch and Administer in Dreamweaver.  

When using WebDAV, it is not possible to use Dreamweaver's Launch & Administer feature.

Windows and Macintosh Issues

In the Contribute Administer Website dialog box, there is a section where you can enter an Administrative Password. This password text box appears blank, even if you enter a password.  The password works, it just doesn't appear in the text box.

Contribute 3 includes in-place image editing features and a new feature called Direct Edit, which enables a user to edit pages that are not a part of a website. The new image editing features cannot be used on pages that are being modified with Direct Edit.

You might see an unusual URL with "MMWIP" in it. This is the location of the staged draft on the server.

If you have dependent files outside the Contribute (site) root, you will need to use absolute paths for these files. Otherwise, Contribute will not upload these files when you publish the draft.

Contribute 3 includes a feature called Edit Page Source in External Application, which allows users to edit the source code for a page in the code editor of their choice. Contribute does not recognize dependent files that are added while you are editing pages in an external code editor. You need to manually upload these files using another FTP client, so that your links to these files are not broken.

Connection Keys will not work when sent through email using Netscape 7 or Novell's Groupwise will not work.

In Contribute 3 you can associate a design-time style sheet with a template so that all instances of the template inherit the styles. However, Contribute will not recognize an associated style sheet until you make a change to the template. The change can be minor, such as adding and deleting a space. After you modify the template in Dreamweaver, upload it to the server, and then refresh your templates in Contribute.

The Contribute administrative user interface is not completely screen reader compliant and is not fully keyboard-accessible.

Contribute 3 does not always handle file and path names with double-byte characters properly. You should avoid using these characters when naming files or directories because they are not supported by the FTP protocol.

Contribute may crash on Macintosh when it is installed to a boot volume that contains double-byte characters, when running in English mode.

If you create a connection that overlaps with a website connection for an existing site managed by CPS, and there are Contribute 3.0 users connected to original site, those users cannot connect to the new (overlapping) website.

Windows Only Issues

The Windows installer for Contribute might take a few minutes to run--possibly more than 5 minutes. If the installer appears to hang, please give it time to finish.

When you install Contribute 3 on Windows 98, you may get an error message requiring you to download the Windows Installer Service. If so, you need to install version 2.0 or higher of the Windows Installer Service on Microsoft's Download Page. Read more about this issue on our Support Website.

Contribute 3 includes the ability to insert Movies in your page. If a movie is playing while in Edit mode, do not click on the controls for the Movie. This may cause Contribute to crash.

Windows 98 will not remember passwords, even if you select the "Don't Ask Me Again" option in Contribute.

You should close Microsoft Internet Explorer (IE) before you uninstall Contribute 3. If IE is open, it might close automatically.

Contribute 3 includes the ability to connect to WebDAV servers, including servers that require Digest Authentication. However, when you use WebDAV to connect to a website that requires Digest Authentication, your website connection might become disabled. This generally occurs after long periods of inactivity. If this happens, select Edit > My Connections to manually enable the website connection.

Macintosh Only Issues

There are several known stability issues with the Contribute embedded browser on Macintosh. Please be sure to install the latest updater for Mac OS X 10.2 or 10.3 to ensure maximum stability.

You might not be able to launch Contribute 3 on Macintosh by double-clicking an .stc file. If you encounter this problem, launch Contribute first, and then double-click the .stc file.

Dialog boxes might appear behind other dialogs, so you will not be able to see them. If Contribute seems to hang, try changing focus to see if there are any hidden dialog boxes. In particular, when you use LAN to connect to a website, the authentication dialog box might appear behind the main window. If this occurs, move the main window out of the way and authenticate as you normally would.

If you drag a file to Contribute 3 to open it, and you haven't set up a .Mac account, you will be prompted to set up an account before you can edit the file. The alternative is to select File > Open, and then browse to the file.

When you browse to a Microsoft Office document, or other non-browsable document, Contribute typically displays a "Placeholder" page. However, if the non-browsable file is located outside of your website, Contribute does not display the placeholder page. Instead, Contribute continues to attempt to load the page until you stop the operation.

Using Contribute with Contribute Publishing Services

Contribute 3.0 and Contribute 3.1 are both compatible with Contribute Publishing Services 1.1. Contribute 3.0 and Contribute 3.1 are also compatible with Contribute Publishing Services 1.0.

Localized versions of Contribute 3.0 are compatible with Contribute Publishing Services 1.1, although 1.1 is English only.

Installing Contribute Publishing Services 1.1 over 1.0

The CPS 1.1 installer detects version 1.0 and automatically installs over it, updating only the necessary files. On Windows, all this happens seamlessly, without your selecting an install location. On Linux and Solaris, the installer requires that you select the exact location of the 1.0 version to update. If you choose to install to a different location, the install does not work.

Installing CPS 1.1 over 1.0 will preserve your website settings and user directory settings.

After installing CPS 1.1 over 1.0, your old CPS administrator’s password should still work.

After installing CPS 1.1 over 1.0, your self-signed SSL certificate is not updated.

If you’re installing CPS 1.1 on a new machine and would like to preserve your CPS 1.0 settings, you should back up the following CPS 1.0 files by copying them to the new location, and then restarting CPS 1.1:

  • C:\Program Files\Macromedia\Contribute Publishing Services\database folder
  • C:\Program Files\Macromedia\Contribute Publishing Services\jrun4\servers\contribute-wps\contribute\WEB-INF\pubservices\sites folder.
  • C:\Program Files\Macromedia\Contribute Publishing Services\jrun4\servers\contribute-wps\contribute\WEB-INF\config\ckm.xml file. (Very important: DO NOT backup the old ckm.xsl file and overwrite the new ckm.xsl file. Only the ckm.xml file should be backed up and new one overwritten.)
  • C:\Program Files\Macromedia\Contribute Publishing Services\jrun4\servers\contribute-wps\contribute\WEB-INF\pubservices\server\serversettings.xml file.

Contribute Publishing Services issues

When connecting Contribute to a CPS server, if you enter an invalid path, Contribute might process for a long time before determining that the path is invalid. Occasionally, an invalid path might cause Contribute to hang.

If any of your server XML files become corrupted, replace them with the BAK backup version in WEB-INF/pubservices/server/serversettings.xml and WEB-INF/config/cps.xml.

You can create several connections to the same CPS server by connecting at different levels. For example, you can connect to https://mycps/, https://mycps.mycompany.com, and https://mycks.macromedia.com/foo.

The Help file for CPS is an HTML file. If it does not appear when you click the Help button, make sure you don't have a "pop-up window" blocker program running. 

If you install CPS on your local machine, and plan to use it with other people in your organization, you must replace "localhost" with your actual machine name when you enter the publishing services URL in the Contribute Administer Website dialog box. For example, https://localhost:8900/Contribute would be https://<your machine name or ip address>:8900/Contribute.

The CPS Linux installer will not run on an IBM 64-bit system running RedHat Linux Enterprise release 3.0.

When installing CPS on a local machine for development, you should not access the CPS by referring to it as "localhost". Instead, use the machine name, or IP address. Instead of using connect:localhost, use connect:machinename or connect:127.0.1.1 (or your specific IP).

Do not use Special (High ASCII) characters in site names. This may cause errors when interacting with the CPS.

Uninstalling CPS from a Windows machine may leave several folders behind. These folders and their contents will need to be manually deleted.

You cannot use High-ASCII or Double-Byte characters in your password when using the User Directory Publishing Service with the "File Based" user directory type.

When setting up the file deployment services on Windows, verify you have the correct network permission settings to copy files. To do this, go to the windows services panel and right-click on Macromedia Contribute Publishing Services, select Properties. Select the "Logon" tab and change the setting from from "Local System" to "Use this account". Enter login and password and hit Apply. Restart the service after this.

CPS doesn't warn you to check in drafts before enabling the User Directory service. If you're adding a site to CPS, and the site has users connected to it, you should ask those users to check in all drafts before you begin managing the site with CPS.

On Linux and Solaris, if you have CPS 1.0 installed, the CPS 1.1 installer behaves as an updater and requires you to select the exact location of the 1.0 version to update. If you choose to install to a different location, the install will not work.

You will receive errors when you try to delete a site from the CPS if someone has that site's CPS folder open in Windows Explorer.

On Windows, you will not be able to install CPS on a machine with JRE 1.5.0.01 and JRun 4 installed. Uninstall JRE 1.5.0.01 before installing CPS 1.1, or deploy CPS as WAR.

If Help in CPS does not appear, please check to make sure you do not have a pop-up windows blocker program running.

Errata

While we try to make the documentation as accurate as possible, some errors are found after the text is sent for translation. Last minute changes and corrections will be published on the Documentation page on the Macromedia website.

FlashPaper Issues

For an up-to-date list of FlashPaper issues, please see the FlashPaper Release Notes.

Reporting a Bug

Found a bug? Your first step should be to contact Macromedia Customer Support. They can help you resolve issues and they can also log bugs. If you're no longer eligible for support, please use the Macromedia Software Feature Request and Bug Report form.

Note: Due to the high volume of e-mail we receive, we are unable to respond to every request.

Thank you for using Contribute and for taking the time to send us your feedback!

Notices, Terms, Conditions, and Attribution

This software may contain third-party software which requires notices and/or additional terms and conditions. Such required third-party software notices and/or additional terms and conditions are made a part of and incorporated by reference into the End User License Agreement (EULA) covering this software.

Product Versions