Plugin Directory

Changeset 2886953

Timestamp:
03/25/2023 11:54:46 PM (17 months ago)
Author:
celloexpressions
Message:

Sheet Music Library: Enable block editor support for Sheet Music post type.

Location:
sheet-music-library/trunk
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • sheet-music-library/trunk/post-type.php

    r1319668 r2886953  
    4646        'publicly_queryable' => true,
    4747        'show_ui'            => true,
     48
    4849        'menu_position'      => 5,
    4950        'menu_icon'          => 'dashicons-format-audio',
  • sheet-music-library/trunk/readme.txt

    r2753437 r2886953  
    22Contributors: celloexpressions
    33Tags: music, sheet music, library, music library
    4 Requires at least: 4.1
    5 Tested up to: 6.0
     4Requires at least: .1
     5Tested up to: 6.
    66Stable tag: 1.2
    77Description: Add a sheet music library, including PDFs, audio, descriptions and more to your site.
     
    99
    1010== Description ==
    11 The sheet music library plugin is a framework that leverages WordPress to post sheet music online in a structured way. Using a sheet music custom post type and taxonomies for composers, genres, difficulties, and orchestrations, you can upload, organize, and share sheet music in a native-feeling interface. In addition to the taxonomies, each "piece" object includes PDF-based score and parts upload (with automatically-generated preview images), and audio upload and/or Youtube/Vimeo embeds to showcase recordings. The native WordPress editor facilitates additional information, be it a sentence explaining the arrangement or a multi-paragraph essay describing a work complete with multimedia content.
     11The sheet music library plugin is a framework that leverages WordPress to post sheet music online in a structured way. Using a sheet music custom post type and taxonomies for composers, genres, difficulties, and orchestrations, you can upload, organize, and share sheet music in a native-feeling interface. In addition to the taxonomies, each "piece" object includes PDF-based score and parts upload (with automatically-generated preview images), and audio upload and/or Youtube/Vimeo embeds to showcase recordings. The native WordPress editor facilitates additional information, be it a sentence explaining the arrangement or a multi-paragraph essay describing a work complete with multimedia content.
    1212
    13 On the front-end, this plugin provides default styling and filtering to display sheet music content in a way that is compatible with most themes. Customizations ranging from visual tweaks with CSS to custom themes that implement the sheet_music post type directly with custom templates allow for infinite possibilities.
     13On the front-end, this plugin provides default styling and filtering to display sheet music content in a way that is compatible with most themes. Customizations ranging from visual tweaks with CSS to custom themes that implement the es.
    1414
    1515Whether you're a composer/arranger publishing your works online, a community or school orchestra sharing music with your members, or work with music in any other way, the Sheet Music Library plugin provides an easy, flexible way to manage and share your content.
    1616
    17 Note that this plugin was designed with classical music in mind in particular, but it can be used in much broader contexts. It was built for the <a href="http://celloexpressions.com/music/">Cello Expressions Sheet Music Library</a>, which provides a good example of what it can do/how it can look on the front end. The backend UI is just as much of a reason to try this plugin, with its seamless integration with WordPress core features.
     17Note that this plugin was designed with classical music in mind in particular, but it can be used in much broader contexts. It was built for the <a href="httphow it can look on the front end. The backend UI is just as much of a reason to try this plugin, with its seamless integration with WordPress core features.
    1818
    1919== Installation ==
     
    21211. Download the .zip file and upload the unzipped folder to the `/wp-content/plugins/` directory
    22221. Activate the plugin through the 'Plugins' menu in WordPress
    23 1. The "Sheet Music" post type is now available and can be used to add content. Plan on taking some time to either look at some different themes to find one tht works well with the default styling, add some custom CSS to clean up the styling, or build a fully custom theme with custom templates for the sheet music post type.
     231. The "Sheet Music" post type is now available and can be used to add content. Plan on taking some time to either look at some different themes to find one th.
    24241. Install the Front Page Custom Post Type plugin to show sheet music posts on your front page: https://wordpress.org/plugins/front-page-custom-post-type/. Or, add a link to the "Sheet Music" post type archive to your menu via the customizer.
    25251. The [all_sheet_music] and [latest_sheet_music] shortcodes can be used to add a table-style summary of all music on the site, and you can use the standard WordPress archive/taxonomy views to present music as well.
     
    2828
    2929== Frequently Asked Questions ==
     30
     31
     32
     33
     34
     35
    3036= Problems with PDF Preview Images =
    3137This plugin has a handy feature that generates images from PDF files that are uploaded. However, it requires a server-side image processing feature called Imagick (or ImageMagick). If image previews of PDFs aren't working, this feature is likely missing. Contact your host to see whether it can be enabled. In some cases, your best option may even be to switch to a host that supports this feature, if image previews of PDFs are a must-have feature.
     
    3743
    3844= Shortcodes =
    39 To display all sheet music in a table view, write the following on its own line in a post/page content area: `[all_sheet_music]`. If you have a lot of sheet music, you could also use `[latest_sheet_music number="10"]` and specify the number of pieces to display. If you want to get a playlist of the audio files associated with sheet music, use `[sheet_music_audio_playlist]`. This shortcode also supports a genre argument - give it the slug (URL extension) for the genre you want to display: `[sheet_music_audio_playlist genre="classical"]`. Generally speaking, it is better to use post type archives and taxonomy views where possible (see the installation instructions for details).
     45To display all sheet music in a table view, write the following on its own line in a post/page content area: `[all_sheet_music]`. If you have a lot of sheet music, you could also use `[latest_sheet_music number="10"]` and specify the number of pieces to display. If you want to get a playlist of the audio files associated with sheet music, use `[sheet_music_audio_playlist]`. This shortcode also supports a genre argument - give it the slug (URL extension) for the genre you want to display: `[sheet_music_audio_playlist genre="classical"]`. Generally speaking, it is better to use post type archives and taxonomy views where possible (see the installation instructions for details).
    4046
    4147== Screenshots ==
     
    43492. Archive (search, taxonomy, author, date, etc.) view with the Twenty Fifteen theme.
    44503. Single piece view with the Twenty Fifteen theme.
    45 4. Taxonomy administration for sheet music posts.
    46 5. Custom field administration for sheet music posts.
     514. Taxonomy administration for sheet music posts.
     525. Custom field administration for sheet music posts.
    47536. Automatic, contextual sheet music audio playlist widget on a taxonomy page (showing an "orchestration" term).
    4854
    4955== Changelog ==
    50 = 1.3 - Future =
    51 * Block editor support...
    52 * Adjustments to the unavailable message box.
     56= 2.0 - Future =
     57* Enable the Block Editor for the Sheet Music post type. Sheet music data remains managed within a meta box below the post content, matching the 1.2 interface.
     58* Update minimum WP version to 6.1 for custom taxonomy compatibility with the core query and terms blocks.
     59* Add editor blocks for each component of the default sheet music template filtering display.
     60* Refactor post template filtering to use the same rendering functions as the new sheet music library blocks. Default front-end output display should not change.
     61* Add block patterns for use in sheet music query loop blocks.
     62* Add block patterns for use in theme templates, for sheet music post type single and archive views.
     63* Add collections taxonomy, not displayed by default, for use in query blocks and optional display in custom templates.
     64* Add a playlist block pattern to improve the workflow of adding playlists to posts in the block editor, until core provides feature parity with the classic editor playlist functionality.
     65* Add UI options in the customizer to disable content filtering and to disable default styling, for use when sheet music templates are set up via block UI and the site editor.
     66* Add file date modified display to all file download buttons.
     67* Minor adjustments to the direct download unavailable message box.
     68* Add styling to support small audio players, which can be enabled through the `.condensed-audio` CSS class and is included in some block patterns.
    5369
    5470= 1.2 =
     
    7187
    7288== Upgrade Notice ==
     89
     90
     91
    7392= 1.1 =
    7493* Adds audio players to table views and support for plugin language packs.
Note: See TracChangeset for help on using the changeset viewer.