Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
=== tf Song List ===
Contributors: ipm-frommen
Donate link:
Tags: song list, songlist, songs, repertoire, bands, musicians, performers, music
Requires at least: 3.0
Tested up to: 3.9.1
Stable tag: trunk
License: GPLv2
License URI:

tf Song List is an easy-to-use song listing plugin for bands and solo musicians.

== Description ==

**tf Song List is an easy-to-use song listing plugin for bands and solo musicians.**  
Conveniently manage your song list directly from within the WordPress backend, make use of the nifty CSV import/export functionality, and style the actual output entirely to your liking.

Take a look at the <a href="" target="_blank">live example</a>, read through the <a href="" target="_blank">documentation</a>, or just <a href="">download</a> the plugin right now.

= Features =

**Manage Songs**

* add new songs to the song list
* edit/delete existing songs
* delete the entire song list
* set song status to public (listed both on frontend and backend) or private (listed on backend only)
* filter the song list by the song status (all songs, public songs, private songs)


* import songs from a CSV file and insert them into the current song list (duplicates will be detected)
* import songs from a CSV file and replace the current song list with the import
* export the entire song list as a CSV file
* export only the public songs as a CSV file


* provide an optional introduction to the song list (some HTML tags allowed)
* order the song list by artist or title
* choose the column order "artist | title” or “title | artist”
* define custom names for the artist and title columns
* show/hide column names (i.e., table head)


* make use of the integrated class names and IDs
* copy the frontend stylesheet to your template directory and thus be independent of any plugin updates

= Translations =

The plugin originally comes with English, German and Spanish language.

If you would like to provide a translation for a currently not included language, please go ahead and do that! I would highly appreciate it, and include the file in the next update.

You may either download and work with the current POT file that is located in the `languages` folder, or use a plugin (e.g., <a href="" target="_blank">Codestyling Localization</a>) to read the relevant text portions from the plugin files. Then send me the respective <a href="[tf Song List] Translation">PO/MO file via e-mail</a>.

== Installation ==

1. Upload the `tf-song-list` folder to the `/wp-content/plugins/` directory on your web server.
2. Activate the plugin through the _Plugins_ menu in WordPress.
3. To display the song list, simply put `[tf_song_list]` in the content of your desired page.

== Frequently Asked Questions ==

 &rarr; <a href="" target="_blank">Frequently Asked Questions</a>.

== Screenshots ==

1. **Songs page** - Here you can view the song list, add new songs, edit or delete existing ones, or even delete the entire song list itself.
2. **Settings page** - Here you can customize the introduction to the actual song list, the names for the _Artist_ and _Title_ columns, the sorting and the like.
3. **Import/Export page** - Here you can import songs from a CSV file, or export your current list to a CSV file.

== Changelog ==

= 1.1.0 =

* Compatible up to WordPress 3.9.1
* Add Spanish translations (thanks to the guys over at WebHostingHub, especially Jelena Kovacevic and Andrew Kurtis)
* Move `/css` folder into new `/assets` folder
* Remove `index.php` files
* Clean up

= 1.0.9 =

* Added `stripslashes_deep` to `artist` and `title` when inserting/updating a song _by hand_.

= 1.0.8 =

* Restricted `add_cap` and `remove_cap` functions to editable roles only.

= 1.0.7 =

* Added song list wrapper element and according `#tfsl-wrapper` CSS.
* For actions, filters and the like, replaced class objects by class names.
* For function calls of current class, replaced `$this` by `self::`.

= 1.0.6 =

* Added Settings and Documentation links to plugin description on Installed Plugins page.
* Updated translations.

= 1.0.5 =

* Changed `the-tfsl-list` class to `tfsl-the-list`.
* Adapted `tf-song-list.css` to new `tfsl-the-list` class.
* Added version number to stylesheets and script files.
* Renamed script files from `*-scripts.js` to `*-functions.js`.
* Removed link to external POT file from readme. The file comes with the plugin, anyway.

= 1.0.4 =

* Changed text domain from `tfsl` to `tf-song-list`.
* Added German language files.

= 1.0.3 =

* Encoding for CSV import/export explicitly set to UTF-8.
* Fixed output formatting of song list data.

= 1.0.2 =

* Fixed `dbDelta` function call in `db.php`, again.

= 1.0.1 =

* Fixed `dbDelta` function call in `db.php`.

= 1.0.0 =

* Initial release.


tf Song List is an easy-to-use song listing plugin for bands and solo musicians.