The FileImporter and FileExporter extensions aim to make moving files from a local wiki to Wikimedia Commons easier. The new functionality allows to move files with all their original data intact, while documenting the move in the version history.
The FileExporter provides a link to Wikimedia Commons on the local wiki and hands over a URL to the extension FileImporter. The FileImporter is a Wikimedia Commons extension which imports the file including all data when all prerequisites are met. Technically, the files won't be "moved", but "copied".
FileImporter has been deployed to Wikimedia Commons in June 2018. To make use of it, you need to activate the FileExporter as a beta feature in your local wiki.
FileImporter and FileExporter aim to fulfill a request from the German-speaking community's Technical Wishlist and are developed by WMDE's tech team. More information can be found on the main project page on Meta.
1) To enable the FileExporter on a local wiki, you have to be logged in and tick the checkbox for FileExporter on the beta features preferences page. (Be sure to visit the preferences page for the wiki from which you intend to export files. The preceding link will take you to the preferences page for the MediaWiki wiki.) You don't have to activate the FileImporter on Wikimedia Commons.
2) There needs to be a configuration file for your wiki. Many files already exist, based on the files from the CommonsHelper2 tool. We're asking users to have a look at them and update or create them if needed to make sure the imports are done right. For more info, read the documentation how the configuration files work and what they are needed for.
Step by step
You need to be logged in in order to use the feature.
2: The FileImporter checks if the file can be imported and if templates need to be replaced during the import. This step is based on the wiki's configuration file. Read more.
3: A preview page on Commons shows you what will be imported. You can edit the file title and page information, and ask the FileImporter to clean up the source wiki in your name, by adding a template like NowCommons to the source file, or deleting the source file if you have admin rights. Clicking on “Import File” copies the file to Commons.
How imported files can be found
- In the revision history of a file, the import is shown as a null revision (i.e. an entry in the revision list that doesn’t actually change the page).
- For the import, an upload log entry and an import log entry are created and associated with the null revision and with the importing user, and timestamped with the import date. Having both the null revision and the upload log entry is the default for uploads, although it leads to "doubled" entries on the history page, see this example file and its log entries.
- For (old) imported file revisions, upload log entries are created with the date and user of the original upload to make all file revisions appear in Commons' upload log.
- Imports are tagged with the tag
fileimporter, so you can filter them in Recent Changes.
- 2018-06-12: Export to test.wikipedia.org
- 2018-06-25: Export to Wikimedia Commons
- FileExporter as a beta feature on wikisource OK
- August 2019:
- Deployment of the FileExporter as a default feature to first wikis