Shortnotes

描述

Shortnotes adds a custom post type, Notes, intended for use when publishing short pieces of content, similar to that found on Twitter, Instagram, and other social networks.

No titles

The Notes post type does not support traditional titles.

Note titles are not generally meant to be displayed as part of the theme layout. You will likely need to adjust the look and feel of your theme accordingly. See the Theme Customization section below for more details.

A title is generated automatically from note content and is used as the note’s document title. This is readable by search engines and displayed in browser tabs.

Limited blocks

The Notes post type uses only basic content blocks like paragraph, image, gallery, video, and embed. Using a defined list of relatively simple blocks helps to keep notes simple.

Webmention support

The Notes post type includes support for the Webmention and Semantic-Linkbacks plugins.

URLs in note content are processed as possible webmentions.

A panel in the block editor allows for the addition of a reply to URL and name. When entered, they are used to provide markup for a semantic webmention reply.

Reply to template tag

The reply specification works best when the u-in-reply-to element is outside of the main content element, defined by e-content.

A template tag is provided as part of the Shortnotes plugin that can be used to output reply to markup in your theme.

<article class="h-entry">
    <?php
    if ( function_exists( 'ShortNotes\PostType\Note\reply_to_markup' ) ) {
        \ShortNotes\PostType\Note\reply_to_markup();
    }
    ?>
    <div class="entry-content e-content">
        <?php the_content(); ?>
    </div><!-- .entry-content -->
</article>

If this template tag is not used, then the Shortnotes plugin will automatically prepend the reply to markup to the_content.

Theme Customization

No customization of your theme is required to use this plugin, though you will likely want to think through how titles are displayed and if you want full support for webmentions.

If you do find yourself wanting to customize, I have made adjustments to my site’s theme, a child theme of Twenty Twenty One, while developing this plugin, that can be used as an example.

Those adjustments (a) remove the display of a title for the note post type and (b) output reply to markup outside of the main content element.

评价

2022年4月2日
I love these indieweb type plugins, especially where hey break out indieweb types into their own cpt, this is a much better approach of using post for everything
阅读所有0条评价

贡献者及开发者

“Shortnotes” 是开源软件。 以下人员对此插件做出了贡献。

贡献者

将“Shortnotes”翻译成您的语言。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

1.3.1

  • Update @wordpress/scripts dependency to 23.2.0.
  • Confirm WordPress 6.0 support.

1.3.0

  • Add a shortnotes_post_type_arguments filter.
  • Fix a minor documentation issue.
  • Update @wordpress/scripts dependency to 23.0.0.

1.2.0

  • Fix a bug in title generation when an image block is followed by a paragraph.
  • Start tracking note type: note or reply.
  • Improve reply-to interface to appear only when the note type is a reply.
  • Update @wordpress/scripts dependency to 22.3.0.

1.1.5

  • Introduce common function to generate a shortnote’s subtitle.
  • Parse non-Gutenberg HTML blocks for possible sub title content.

1.1.4

  • Add shortnotes_formatted_title filter to allow for additional title filtering elsewhere.

1.1.3

  • Stop editor from crashing when a note is saved in Gutenberg 11.4.0+.

1.1.2

  • Add shortnotes_reply_to_name filter.
  • Update @wordpress/scripts dependency to 19.2.2.
  • Rebuild JavaScript asset with latest WP scripts.

1.1.1

  • Confirm support for WordPress 5.8.
  • Update @wordpress/scripts dependency to 17.0.0.
  • Rebuild JavaScript asset with latest WP scripts.
  • Remove unused get_version() function before it’s too late!

1.1.0

  • Add support for more simple core blocks: video, file, embed, etc…
  • Fix overeager loading of plugin assets on post types that are not shortnote.

1.0.2

  • Fix display of “(no title) is now live.” in block editor when new note is published.