https://github.com/garraflavatra/webtrees-media-folder-import

A webtrees module that adds the possibility to import all media files in the same folder at once from within the admin panel.
https://github.com/garraflavatra/webtrees-media-folder-import

webtrees webtrees2

Last synced: about 13 hours ago
JSON representation

A webtrees module that adds the possibility to import all media files in the same folder at once from within the admin panel.

• Host: GitHub
• URL: https://github.com/garraflavatra/webtrees-media-folder-import
• Owner: garraflavatra
• License: gpl-3.0
• Created: 2023-08-18T09:32:46.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-20T07:06:25.000Z (about 1 year ago)
• Last Synced: 2023-08-20T08:22:37.826Z (about 1 year ago)
• Topics: webtrees, webtrees2
• Language: PHP
• Homepage:
• Size: 1.01 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Webtrees media folder import module

This webtrees module adds the possibility to import all media files in the same folder at once from within the admin panel.

## Installation

Download an archive of [the latest release](https://github.com/garraflavatra/webtrees-media-folder-import/releases/latest) and unzip it into the `modules_v4` folder of your webtrees installation. Subsequently, enable it in the administration panel using the "All modules" link in the "Modules" section.

## Usage

Go to the "Modules" box in the administration panel, and click the "Import media files from folder" link. Select the tree where you want to import the media files to.

You can now specify the name of the folder (relative to your `data/media` directory) which contains the files that you want to import. Subdirectories are not included. If an included file is already exists as a media object in your tree, it will be skipped to prevent double media objects. It's also possible to search for a folder by using the autocomplete feature.

Additionally, specify the title you want to give your imported media objects. The following replacements will be performed:

* `{index}` is replaced with the index of the file (e.g. 1).

* `{counter}` is replaced with a counter (e.g. 000001).

* `{basename}` is replaced with the base name of the file (e.g. photo.jpg).

* `{filename}` is replaced with the name of the file (e.g. photo).

You can optionally specify additional fields (i.e. media type, notes and restriction) that will be the same for all imported files.

![Screenshot](./resources/screenshot.png)

## Author & license

© [Romein van Buren](mailto:[email protected]) 2023.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see .