https://github.com/TimPerry/acf-post-type-selector

Post type selector for Advanced Custom Fields
https://github.com/TimPerry/acf-post-type-selector

Last synced: 27 days ago
JSON representation

Post type selector for Advanced Custom Fields

• Host: GitHub
• URL: https://github.com/TimPerry/acf-post-type-selector
• Owner: TimPerry
• Created: 2012-11-28T17:09:02.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2021-03-04T10:03:23.000Z (almost 4 years ago)
• Last Synced: 2024-08-09T17:37:58.921Z (4 months ago)
• Language: PHP
• Size: 38.1 KB
• Stars: 56
• Watchers: 5
• Forks: 27
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-acf - Post Type Selector - Provides the option to select a single or multiple post types. (Third-Party Add-Ons)

README

        
# Advanced Custom Fields: acf-post-type-selector Field

* **Contributors:** [@timperry](https://github.com/timperry), [@shaunbent](https://github.com/shaunbent), @emaildano, @rafegoldberg, @thomasdebruin, @gnowland 

* **Tags:** ACF, Post Type Selector

* **Requires at least:** 4.0

* **Tested up to:** 5.0.0

* **Stable tag:** trunk

* **License:** GPLv2 or later

* **License URI:** http://www.gnu.org/licenses/gpl-2.0.html

## Description

Provides the option to select a single or multiple post types

## Compatibility

This add-on will work with:

* version 5 and up

* version 4 and up

## Installation

This add-on can be treated as both a WP plugin and a theme include.

### Plugin

1. Copy the 'acf-post-type-selector' folder into your plugins folder

2. Activate the plugin via the Plugins admin page

### Include

1. Copy the 'acf-post-type-selector' folder into your theme folder (can use sub folders). You can place the folder anywhere inside the 'wp-content' directory

2. Edit your functions.php file and add the code below (Make sure the path is correct to include the acf-post-type-selector.php file)

##### ACF Version 4

        add_action( 'acf/register_fields', 'my_register_fields' );

        function my_register_fields() {

	

             include_once( 'acf-post-type-selector/post-type-selector-v4.php' );

    

        }

        

##### ACF Version 5

        add_action( 'acf/include_fields', 'my_register_fields' );

        function my_register_fields() {

	

             include_once( 'acf-post-type-selector/post-type-selector-v5.php' );

    

        }

## Usage

### Get Field Value

```

$post_type_var = 'post_type';

$post_type = get_sub_field( $post_type_var );

```

### Get Field Value and Display Label

```

label; ?>

```


### Filter available post types

By default, only post types with parameter `public` will be shown. If you need to show non-public post types use the filter `post_type_selector_post_types` as described below. This filter also allows you to remove post types from the list.

```

add_filter( 'post_type_selector_post_types', function( $post_types, $field ) {

	$post_types['foo'] = get_post_type_object( 'foo' );

	unset( $post_types['post'] );

	return $post_types;

}, 10, 2 );

```

## Changelog

### 1.0.1

* Filter available post types

### 1.0.0

* Support for ACF `v5`

### 0.0.1

* Initial Release.