Skip to content
WordPress plugin 'Custom Post Type Widgets' adds default custom post type widgets.
PHP Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
inc style: trim period Aug 7, 2019
languages fix japanese translation Apr 13, 2016
tests
.editorconfig add .editorconfig Oct 14, 2017
.gitignore initial release Jan 27, 2015
.travis.yml test: fix .travis.yml Apr 30, 2019
LICENSE docs: add LICENSE file Feb 18, 2018
README.md
composer.json test: add composer.json for test Feb 27, 2019
custom-post-type-widgets.php version 1.2.0 Aug 8, 2019
phpcs.ruleset.xml
phpmd.ruleset.xml test: fix static code analysis config Feb 27, 2019
phpstan.neon test: add static code analysis config Feb 27, 2019
phpunit.xml
readme.txt
screenshot-1.png
screenshot-2.png
screenshot-3.png initial release Jan 27, 2015
screenshot-4.png initial release Jan 27, 2015
screenshot-5.png initial release Jan 27, 2015
screenshot-6.png
screenshot-7.png add screenshot Apr 13, 2016

README.md

Introducing Custom Post Type Widgets

Build Status

WordPress

This WordPress plugin adds default custom post type widgets. You can filter by registered Custom Post Type or Taxonomy on widgets.

How do I use it?

  1. Download and unzip files. Or install Custom Post Type Widgets plugin using the WordPress plugin installer. In that case, skip 2.
  2. Upload "custom-post-type-widgets" to the "/wp-content/plugins/" directory.
  3. Activate the plugin through the 'Plugins' menu in WordPress.
  4. Adds widgets to a widget area and configure settings through the 'Widgets' menu in WordPress.
  5. Have fun!

IMPORTANT: By default, WordPress will not work Date-based permalinks of custom post type. Recommend that you install the plugin in order to edit the permalink, if you are using a Date-based permalinks.

And try the following: Custom Post Type Rewrite

Descriptions of Widgets

Recent Posts (Custom Post Type)

display a list of the most recent custom posts.

  • Title - description that appears over the list of recent custom posts.
  • Post Type - if selected, filter by a custom post type. (e.g. post).
  • Number of posts to show (at most 15) - enter the number of posts to display.
  • Display post date? - if checked, display post date.
  • Class Name - widget_recent_entries

Archives (Custom Post Type)

display a list of archive links for each month that has custom posts.

  • Title - description that appears over the list of archive links.
  • Post Type - if selected, filter by a custom post type. (e.g. post).
  • Display as dropdown - if checked, this box causes the archives to be displayed in a drop-down box.
  • Show post counts - if checked, this box causes a count of the number of posts for each archive period.
  • Class Name - widget_archive

Categories (Custom Post Type)

display a list of categories that has custom posts.

  • Title - description that appears over the list of categories.
  • Taxonomy - if selected, filter a custom taxonomy (e.g. category).
  • Display as dropdown - if checked, this box causes the categories to be displayed in a dropdown box.
  • Show post counts - if checked, this box causes the count of the number of posts to display with each category.
  • Show hierarchy - if checked, shows parent/child relationships in an indented manner.
  • Class Name - widget_categories

Calendar (Custom Post Type)

display a calendar of the current month.

  • Title - description that appears over the calendar.
  • Post Type - if selected, filter by a custom post type. (e.g. post).
  • Class Name - widget_calendar

Recent Comments (Custom Post Type)

display a list of the most recent comments.

  • Title - description that appears over the list of recent comments.
  • Post Type - if selected, filter by a custom post type. (e.g. post).
  • Number of comments to show (at most 15) - enter the number of comments to be displayed.
  • Class Name - widget_recent_comments

Tag Cloud (Custom Post Type)

display a list of the top 45 that has used in a tag cloud.

  • Title - description that appears over the tag cloud.
  • Taxonomy - if selected, filter a custom taxonomy (e.g. post_tag).
  • Show tag counts - if checked, this box causes the count of the number of tags to display with each tag.
  • Class Name - widget_tag_cloud

Search (Custom Post Type)

A search form for your site.

  • Title - description that appears over the search.
  • Post Type - if selected, filter by a custom post type. (e.g. post).
  • Class Name - widget_search

Hooks

Filter hooks

  • custom_post_type_widgets/archive/widget_archives_dropdown_args
  • custom_post_type_widgets/archive/widget_archives_args
  • custom_post_type_widgets/categories/widget_categories_dropdown_args
  • custom_post_type_widgets/categories/widget_categories_args
  • custom_post_type_widgets/recent_comments/widget_comments_args
  • custom_post_type_widgets/recent_posts/widget_posts_args
  • custom_post_type_widgets/search/filter_post_type
  • custom_post_type_widgets/tag_cloud/widget_tag_cloud_args

Action hooks

  • custom_post_type_widgets/recent_posts/widget/before
  • custom_post_type_widgets/recent_posts/widget/prepend
  • custom_post_type_widgets/recent_posts/widget/append
  • custom_post_type_widgets/recent_posts/widget/after

WordPress Plugin Directory

Custom Post Type Widgets is hosted on the WordPress Plugin Directory.

https://wordpress.org/plugins/custom-post-type-widgets/

Test Matrix

For operation compatibility between PHP version and WordPress version, see below Travis CI.

Contribution

Patches and Bug Fixes

Small patches and bug reports can be submitted a issue tracker in Github. Forking on Github is another good way. You can send a pull request.

  1. Fork Custom Post Type Widgets from GitHub repository
  2. Create a feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Create new Pull Request

Changelog

  • Version 1.2.0
    • change Requires at least version 4.0
    • [Calendar widget] cache the calendar
    • improve filter hooks and action hooks
    • fix test case
    • refactoring
    • add customize_selective_refresh
    • fix phpcs.ruleset.xml
    • replace from strip_tags to wp_strip_all_tags
    • replace from _e to esc_html_e
    • add PHPDoc
    • fix header
    • add reset-wp-tests.sh, uninstall-wp-tests.sh
    • fix indent and reformat with phpcs and phpcbf
    • add composer.json for test
    • add static code analysis config
  • Version 1.1.3
    • change Requires at least version 3.7
    • fix add_action
    • add sanitize
    • add tests
  • Version 1.1.2
    • [Categories widget] change value_field of the cat_args from name to slug
    • limit the scope of the filter hook
    • [Search widget] rename the name of the filter hook
    • fix the initial value of the posttype, the archive_name and the taxonomy
  • Version 1.1.1
    • [Search widget] add apply_filters 'WP_Custom_Post_Type_Widgets_Search_filter_post_type'
    • [Search widget] improve function 'query_search_filter_only_post_type'
    • [Search widget] change to add_action 'pre_get_posts' run only on the front-end page
  • Version 1.1.0
    • [Comments widgets, Search widgets] add 'All' to posttype option
    • refactoring
    • add Custom Post Type Search widget
  • Version 1.0.4
    • fix cache key of Custom Post Type Calendar widget
    • support for custom post type slugs
    • add german translation
  • Version 1.0.3
    • add italian translation
  • Version 1.0.2
    • fix $cat_args['show_option_none']
  • Version 1.0.1
    • fix the 'name' param of get_terms()
  • Version 1.0.0
    • Initial release

Upgrade Notice

  • 1.2.0
    • Requires at least version 4.0 of the WordPress
  • 1.1.3
    • Requires at least version 3.7 of the WordPress

License

Licensed under GPLv2.

You can’t perform that action at this time.