%META:TOPICINFO{author="ProjectContributor" date="1655468868" format="1.1" version="1"}%
%META:TOPICPARENT{name="Plugins"}%
---+!! !TWikiCompatibilityPlugin
%FORMFIELD{"Description"}%

%TOC%

---++ Usage
Automatically maps requests for legacy TWiki web topics to Foswiki free topics as per
[[http://foswiki.org/Development/TopicNameMappingTable][TopicNameMappingTable]].

Map TWIKIWEB to SYSTEMWEB - no Preference setting required.

to add similar auto-compatibility for attachments, add (or uncomment) the following !ErrorDocument handling to
your Apache configuration _in the =pub= section_

<verbatim>
    #for TWikiCompatibility
    ErrorDocument 404 /foswiki/bin/viewfile
</verbatim>

---++ Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -&gt; "Install, Update or Remove extensions" Tab.  Click the "Search for Extensions" button.  
Enter part of the extension name or description and press search.   Select the desired extension(s) and click install. If an extension is already installed, it will *not* show up in the
search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
<verbatim>
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install
</verbatim>

If you have any problems, or if the extension isn't available in =configure=, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.


---++ Info

Many thanks to the following sponsors for supporting this work:
   * Acknowledge any sponsors here

---++ Dependencies
None

---++ Change History
%TABLE{columnwidths="7em" tablewidth="100%"}%
|  1.1.2 | Released with Foswiki 1.1.4 - minor cleanup of topics and code. |
|  1.1.1 | Foswikitask:Item9415 - Documentation updates |
|  1.1 | Foswikitask:Item8669 - MAINWEB mapping removed. It has instead been added to %WIKIPREFSTOPIC% in Foswiki 1.1 and forward so that upgraders do not have to enable this plugin just to map MAINWEB to USERSWEB. Many upgraders will not need any other function and would rather not have the code overhead of this plugin |
|  1.0 | Version shipped with Foswiki 1.0.X |

---
*Related Topics:* [[%SYSTEMWEB%.Plugins][Plugins]], %SYSTEMWEB%.DeveloperDocumentationCategory, %SYSTEMWEB%.AdminDocumentationCategory, %SYSTEMWEB%.%WIKIPREFSTOPIC%, %LOCALSITEPREFS%

%META:FORM{name="PackageForm"}%
%META:FIELD{name="Author" title="Author" value="Sven Dowideit, Michael Daum, Crawford Currie"}%
%META:FIELD{name="Copyright" title="Copyright" value="&copy; SvenDowideit@fosiki.com"}%
%META:FIELD{name="Description" title="Description" value="Add TWiki personality to Foswiki"}%
%META:FIELD{name="Home" title="Home" value="http://foswiki.org/Extensions/TWikiCompatibilityPlugin"}%
%META:FIELD{name="License" title="License" value="[[http://www.gnu.org/licenses/gpl.html][GPL3 (Gnu General Public License)]]"}%
%META:FIELD{name="Release" title="Release" value="15 Mar 2026"}%
%META:FIELD{name="Repository" title="Repository" value="https://github.com/foswiki/distro"}%
%META:FIELD{name="Support" title="Support" value="http://foswiki.org/Support/TWikiCompatibilityPlugin"}%
%META:FIELD{name="Version" title="Version" value="1.12"}%
