README

Creates a rich input field that allows a user to curate and rank content items (posts or other custom post types)

Caution

As of 12 April 2024, this project is archived and no longer being actively maintained.

Installation

Clone the plugin to your wp-content/plugins/ directory.

Usage

In your theme, you can call pf_render( $name, $value, $options ) where you want to display a Post Finder field.

$name : Name you want to use on the input field

$value : Currently selected value(s). Should be a comma-separated string of post_ids

$options (optional) : Array of options that will be used to build the input

Current options

show_numbers - Whether to show a positional number next to each item. Makes it easy to see which position each item has. Default true.
show_recent - Whether to show the Recent Post select input. Default true.
limit - Limit how many items can be selected. Default 10.
args - Array of arguments passed to our WP_Query instances. Allows customizations of these queries, like setting a specific post type. See the WordPress Developer Reference for supported arguments.
include_script - Whether to include the init script for the input. Default true. If false, you'll have to include this yourself in order for it to work.

jQuery( document ).ready( function( $ ) {
	$( '.post-finder' ).postFinder();
} );

Support Level

Archived: This project is no longer maintained by 10up. We are no longer responding to Issues or Pull Requests unless they relate to security concerns. We encourage interested developers to fork this project and make it their own!

Changelog

A complete listing of all notable changes to Post Finder are documented in CHANGELOG.md.

Contributing

Please read CODE_OF_CONDUCT.md for details on our code of conduct, CONTRIBUTING.md for details on the process for submitting pull requests to us, and CREDITS.md for a listing of maintainers of, contributors to, and libraries used by Post Finder.

10up / post-finder

Maintainers

Details