Description
Imports sermons into Sermon Manager for WordPress using ID3 information. Only MP3 files are currently supported. Files can either be uploaded via the WordPress uploader or through another method. The plugin adds files to the wp-content/uploads/sermon-manager-import
folder by default. A different folder can be specified in the options. The plugin only searches the base folder specified! Files added through the WordPress uploader will show up in the media library as unattached. The files are then attached to the sermon when imported.
When the sermon is posted, the file is moved to the uploads folder using the organization method selected in the WordPress settings. Sermons can be posted in the publish
or draft
status.
Warning there are a few warnings you should read in the Other Notes
section.
Contributing
If you want to contribute go to Github, fork, and send a pull request. Issues and comments are welcome as well.
**WARNINGS**
- All uploads identified as
audio/mp3
(usually only MP3 files) are uploaded to the import folder specified. All other files will be uploaded to the normal upload directory. - When posting a file that is an unattached entry, the unattached entry will be deleted. Normally, this is not an issue and is only a temporary entry. However, if you manually attached the uploaded media to a post, it will not work after importing the sermon. This is an unlikely scenario.
- This plugin does not have the ability to add media already in the WordPress media library to sermon manager. To do this, one would manually (ssh, ftp, etc) move the files to the specified import folder. Then continue as normal. This method will delete the previous entry in the media library. If you have the media attached to another post, the old post will not work.
- While this plugin is activated, mp3 files will go to the folder specified in the
Import Options
. I recommend you activate this plugin only when needed and disable it when not needed.
TODO (if interest is expressed)
- Add featured image from ID3 embedded picture
- Import other types of audio files
Thank you
Thank you Jack for creating a useful and well documented plugin. Other themes and plugins are available at WordPress for Church.
Tom McFarlin’s WordPress Plugin Boilerplate.
James Heinrich’s getID3.
Paul Sheldrake’s MP3 to Post Plugin.
Screenshots
Installation
- Upload the plugin directory to the
/wp-content/plugins/
directory via FTP orgit clone https://github.com/khornberg/sermon-manager-import
in the/wp-content/plugins/
directory. - Activate the plugin through the ‘Plugins’ menu in WordPress
FAQ
- Why do my uploads keep going to the sermon-manager-import folder?
-
While this plugin is activated, mp3 files will go to the folder specified in the
Import Options
. I recommend you activate this plugin only when needed and disable it when not needed. - What is ID3?
-
ID3 is metadata for most MP3 files. When you use a media player (e.g. iTunes, Windows Media Player, etc.) the title, artist, etc. is stored within each file in the ID3 format.
- I get a `Fatal error: Maximum execution time of 30 seconds exceeded`
-
Likely you are importing a lot of sermons. Refresh the page and import all of the remaining sermons again. Repeat as necessary if that doesn’t do it. Your server is set to run a process for limited time. When importing many sermons, you reach this limit and the server lets you know.
- Does this work with Amazon S3 or other services?
-
Not sure. Please let me know.
- Can I help?
-
Sure can. See the Contributing / Other Notes section.
Contributors & Developers
“Sermon Manager Import” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Sermon Manager Import” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.5
- Fixed some PHP-Issues
- Updated ID3-Code to newest Version
- Added compatibility to PHP 7
- Added possibility to call the import-function via shortcode. Just create a page and add [import_all_sermons]. After pushing a new mp3-File to the import-Folder, simply open the created page and the Files are published.
0.2.3
- Readme update
0.2.2
- Sets new podcasting options as of Sermon Manager 1.8
- Add explanation when files are not imported
- Made details screen more clear
0.2.1
- Added option to set service type based on meridiem
- Remove old files
0.2
- Added GUI to allow customized bind of ID3 tags to Sermon Manager fields (e.g. comment to bible passage, date from the file name, etc.)
- Warns if sermon manager not activated, will not import if the sermon manager plugin is not activated
- Added support to import sermon as a draft
- Added Options page
- Can find multiple date formats and use them for the date of the sermon
- Code refactor for use on WordPress Multisite, efficiency, maintainability
- Removed bootstrap dependency
- Updated WordPress help screen
0.1
- Initial Release