Pilo'Press

Mô tả

Pilo’Press is a framework plugin for WordPress. Based on ACF and ACF Extended, it allows you to create layouts among other things and use the Flexible Content field as a page builder.

Pilo’Press uses Tailwind CSS for style templating which can be setup and build directly from the back-office.
Please note that Tailwind CSS is not mandatory, you can choose to use it or not.

Requirements

This plugin requires Advanced Custom Fields PRO and Advanced Custom Fields: Extended plugins in order to work correctly.

Getting started

  1. Activate Advanced Custom Fields Pro plugin
  2. Activate ACF Extended plugin
  3. Activate Pilo’Press plugin
  4. In your theme, create a pilopress folder
  5. Within the pilopress folder, create layouts subfolder
  6. Within the pilopress folder, create assets subfolder
  7. In the index.php file, add the following code:

    <?php
    
    get_header();
    
        the_pip_content();
    
    get_footer();
    

Tailwind CSS

In the administration, under Pilo'Press > Styles, when you click on “Update & Compile”, TailwindCSS will be compiled remotely using TailwindAPI. Minified CSS files are then created under /pilopress/assets/styles.min.css and /pilopress/assets/styles-admin.min.css.

You can manually enqueue those files in your theme for the front-end & the back-end, but we recommend to use automatic enqueue code above.

It is possible to manually retrieve the Tailwind PostCSS & JS fields of the administration if you want to build TailwindCSS locally. To do so, you can use the following code:

$tailwind_css = get_field( 'pip_tailwind_style', 'pip_styles_tailwind' );
$tailwind_config = get_field( 'pip_tailwind_config', 'pip_styles_tailwind' );

For more details, see Tailwind CSS Documentation.

Customizing style

To customize default Tailwind CSS styles, go to Pilo'Press > Styles from left navigation menu or top bar menu.

For more details about customization, see Github Page.

Add new layout

  • In the admin menu Pilo'Press > Layouts, add a new layout
  • Configure the layouts fields
  • Create PHP, CSS and JS files in your theme layout folder /your-theme/pilopress/layouts/your-layout
  • You have to name those files the same way you did in back-office settings

Note: only PHP template file is require.

Templating

To display the content of your post, you have to use the following function:

// Pilo'Press content (doesn't need 'echo')
the_pip_content();

// Pilo'Press content (needs 'echo')
echo get_pip_content();

Components

See GitHub Page for complete example.

Hooks

Available hooks are list and describe in GitHub Page

Cài đặt

Plugin Install

  1. Activate Advanced Custom Fields Pro plugin
  2. Activate ACF Extended plugin
  3. Activate Pilo’Press plugin

Theme Install

  1. In your theme, create a pilopress folder
  2. Within the pilopress folder, create layouts subfolder
  3. Within the pilopress folder, create assets subfolder

Đánh giá

There are no reviews for this plugin.

Người đóng góp & Lập trình viên

“Pilo'Press” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.

Những người đóng góp

“Pilo'Press” đã được dịch qua 1 ngôn ngữ. Cảm ơn những người tham gia dịch vì đóng góp của họ.

Dịch “Pilo'Press” sang ngôn ngữ của bạn.

Muốn tham gia phát triển?

Duyệt code, check out SVN repository, hoặc theo dõi nhật ký phát triển qua RSS.

Nhật ký thay đổi

0.3.2.8 – 22/07/2020

  • Fixed: Collection badge style with automatic thumbnail

0.3.2.7 – 22/07/2020

  • Added: pip/layouts/always_show_collection filter
  • Added: Layout configuration file option
  • Added: Allow png, jpeg, jpg file inside layout folder to be used as thumbnail. The file needs to be named as the layout slug.
  • Added: Create layout folder and PHP file on layout creation
  • Improved: Rename helpers functions
  • Improved: Reset TinyMCE styles in a cleaner way
  • Improved: Register conditions for Pilo’Press field types

0.3.2.6 – 16/07/2020

  • Added: Create pilopress/assets and pilopress/layouts folders on plugin activation
  • Improved: ACFE 0.8.6.7 Compatibility
  • Improved: Group Pilo’Press field types under “Pilo’Press” category
  • Improved: Use layout slug to autocomplete file names
  • Improved: Use layout slug for location check, allow multiple layouts to have the same name
  • Improved: Show collection badge only on layouts with the same name instead of on all layouts
  • Fixed: Filters in layout modal when collections are used
  • Fixed: Remove Collection meta box on field group pages
  • Fixed: Translations

0.3.2.5 – 17/06/2020

  • Improved: Collections name tag
  • Improved: Layouts Configuration Modal setting now also display Local Field Groups
  • Fixed: WYSIWYG Dark Mode not working in some specific cases
  • Fixed: Readme URL

0.3.2.4 – 10/06/2020

  • Improved: Collections name in layouts label
  • Improved: Builder name is now displayed in the Builder Modal
  • Fixed: Flexible Content PHP notice
  • Fixed: Builder Mirror being displayed on pages

0.3.2.3 – 10/06/2020

  • Added: pip_maybe_get() helper function
  • Fixed: Fix WYSIWYG dark mode

0.3.2.2 – 09/06/2020

  • Fixed: Fix WYSIWYG dark mode values and detection

0.3.2.1 – 08/06/2020

  • Fixed: Fix WYSIWYG dark mode being required in specific case

0.3.2 – 08/06/2020

  • Added: Dark mode for TinyMCE Editors
  • Added: PHP Sync for layouts
  • Added: Collection taxonomy for layouts, displayed before layout title. Example: “Collection: Layout title”
  • Improved: get_pip_header() and get_pip_footer() are include in the_pip_content()
  • Improved: Styles from Pilo’Press automatically enqueued
  • Improved: Add layouts categories and collection in JSON and PHP files
  • Improved: Hide category and collection columns if no term exist in layouts admin page

0.3.1 – 29/05/2020

  • Improved: Translations
  • Fixed: Save of builder field group

0.3 – 20/05/2020

  • Improved: General Dashboard
  • Fixed: Layouts Json Sync when the folder doesn’t exists
  • Removed: TailwindCSS PostCSS & JS file generation have been removed

0.2 – 19/05/2020

  • Fixed: Layout path prefix field to correctly check theme path
  • Fixed: Google Fonts are now enqueued using wp_enqueue_style()
  • Fixed: TaildwindAPI now use native wp_remote_post() function instead of CURL

0.1 – 14/05/2020

  • Initial commit