This repository has been archived on 2021-10-26. You can view files and clone it, but cannot push or open issues or pull requests.
biofriction-web/biofriction-plugin/bfr-theme-plugin.php

338 lines
11 KiB
PHP

<?php
/**
* The plugin bootstrap file
*
* This file is read by WordPress to generate the plugin information in the plugin
* admin area. This file also includes all of the dependencies used by the plugin,
* registers the activation and deactivation functions, and defines a function
* that starts the plugin.
*
* @link http://example.com
* @since 1.0.0
* @package Plugin_Name
*
* @wordpress-plugin
*/
/*
Plugin Name: Biofriction - website options
Plugin URI: https://biofriction.org/
Description: All the <strong>options</strong> for <strong>Biofriction website</strong> wich do not come by default with wordpress such as: selector for showing buttons, a date picker for old posts, and any other needs.
Version: 0.2
Author URI: https://vitrubio.net/
Author: jorge - vitrubio.net
License: GPL 3.0
Date: 2020 02 10
License URI:https://www.gnu.org/licenses/gpl-3.0.html
Text Domain: bfr_plugin_txtdomain
Domain Path: /languages
*/
/*
if ever read this never forget to check
howto write a pluggin by Wordpress.org
https://codex.wordpress.org/Writing_a_Plugin
and the best practices
https://developer.wordpress.org/plugins/plugin-basics/best-practices/
and some resources
https://themefoundation.com/wordpress-meta-boxes-guide/
*/
defined( 'ABSPATH' ) or die( 'No script kiddies please!' );
/* *
* Load translation, if it exists
* * * * * * * * * * * * * * * * * * */
function bfr_plugin_init() {
$plugin_dir = basename(dirname(__FILE__));
load_plugin_textdomain( 'bfr_plugin_txtdomain', null, $plugin_dir.'/assets/languages/' );
}
add_action('plugins_loaded', 'bfr_plugin_init');
/* *
* add settings link in pluggin page
* * * * * * * * * * * * * * * * * * */
function bfr_plugin_plugin_action_links($links, $file) {
$this_plugin = basename(plugin_dir_url(__FILE__)) . '/bfr-theme-plugin.php';
if($file == $this_plugin) {
$links[] = '<a href="admin.php?page=biofriction-options">' . __('Settings', 'bfr_plugin_txtdomain') . '</a>';
}
return $links;
}
add_filter('plugin_action_links', 'bfr_plugin_plugin_action_links', 10, 2);
/**
* Registers stylesheet for a custom plugin.
*/
function biofriction_theme_plugin_styles_admin() {
add_editor_style( 'assets/css/bfr-theme-plugin.css' );
}
add_action( 'admin_init', 'biofriction_theme_plugin_styles_admin' );
/**
* Proper way to enqueue scripts and styles
*/
function biofriction_theme_plugin_styles_public() {
$this_plugin = basename(plugin_dir_url(__FILE__));
wp_enqueue_style( 'bfr-theme-plugin', plugin_dir_url(__FILE__) . 'assets/css/bfr-theme-plugin.css' );
// wp_enqueue_script( 'script-name', get_template_directory_uri() . '/js/example.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'biofriction_theme_plugin_styles_public' );
/* *
* Custom button in TINYMCE editor for styling
* * * * * * * * * * * * * * * * * * * * * * */
// as read on
// https://codex.wordpress.org/Plugin_API/Filter_Reference/mce_buttons,_mce_buttons_2,_mce_buttons_3,_mce_buttons_4
// https://www.wpbeginner.com/wp-tutorials/how-to-add-custom-styles-to-wordpress-visual-editor/
// https://kinsta.com/blog/wordpress-tinymce-editor/
// Callback function to insert 'styleselect' into the $buttons array
if ( ! function_exists( 'bfr_mce_buttons' ) ) :
function bfr_mce_buttons( $buttons ) {
// array_unshift( $buttons, 'styleselect', 'removeformat' );
array_push( $buttons, 'styleselect', 'removeformat' );
return $buttons;
}
endif;
// Register our callback to the appropriate filter
add_filter( 'mce_buttons_2', 'bfr_mce_buttons' );
// Callback function to filter the MCE settings
if ( ! function_exists( 'bfr_mce_before_init_insert_formats' ) ) :
function bfr_mce_before_init_insert_formats( $init_array ) {
// Define the style_formats array
$style_formats=array(
// Each array child is a format with it's own settings
array(
'title' => 'button',
'block' => 'span',
'classes' => 'button',
'wrapper' => true,
),
array(
'title' => 'button secondary',
'block' => 'span',
'classes' => 'button secondary',
'wrapper' => true,
),
array(
'title' => 'button hollow',
'block' => 'span',
'classes' => 'button hollow primary',
'wrapper' => true,
),
array(
'title' => 'button hollow secondary',
'block' => 'span',
'classes' => 'button hollow secondary',
'wrapper' => true,
),
);
// Insert the array, JSON ENCODED, into 'style_formats'
$init_array['style_formats'] = json_encode( $style_formats );
return $init_array;
}
endif;
// Attach callback to 'tiny_mce_before_init'
add_filter( 'tiny_mce_before_init', 'bfr_mce_before_init_insert_formats' );
// function biofriction_mce_buttons_3( $buttons ) {
// $buttons[] = 'superscript';
// $buttons[] = 'subscript';
// $buttons[] = 'cut' ;
// $buttons[] = 'copy' ;
// $buttons[] = 'paste' ;
// $buttons[] = 'hr' ;
// $buttons[] = 'backcolor' ;
// $buttons[] = 'newdocuement' ;
// $buttons[] = 'formatselect' ;
// $buttons[] = 'fontselect' ;
// $buttons[] = 'fontsizeselect' ;
// $buttons[] = 'styleselect' ;
// return $buttons;
// }
// add_filter( 'mce_buttons_3', 'biofriction_mce_buttons_3' );
/**
*
* Custom settings page
* * * * * * * * * * * * * * * * * * /
*
* @internal never define functions inside callbacks.
* these functions could be run multiple times; this would result in a fatal error.
* https://developer.wordpress.org/plugins/settings/custom-settings-page/
*/
/**
* custom option and settings
*/
function bfr_settings_init() {
// register a new setting for "bfr" page
register_setting( 'bfr_settings', 'bfr_options' );
// register a new section in the "bfr" page
add_settings_section(
'bfr_section_olderthandate',
__( 'Biofrictions Options.', 'bfr_plugin_txtdomain' ),
'bfr_section_olderthandate_cb',
'bfr_settings'
);
// register a new field in the "bfr_section_olderthandate" section, inside the "bfr" page
add_settings_field(
'bfr_field_olderthandate', // as of WP 4.6 this value is used only internally
// use $args' label_for to populate the id inside the callback
__( 'Hide content older than...', 'bfr_plugin_txtdomain' ),
'bfr_field_olderthandate_cb',
'bfr_settings',
'bfr_section_olderthandate',
[
'label_for' => 'bfr_field_olderthandate',
'class' => 'bfr_row',
'bfr_custom_data' => 'custom',
]
);
}
/**
* register our bfr_settings_init to the admin_init action hook
*/
add_action( 'admin_init', 'bfr_settings_init' );
/**
* custom option and settings:
* callback functions
*/
// olderthandate section cb
// section callbacks can accept an $args parameter, which is an array.
// $args have the following keys defined: title, id, callback.
// the values are defined at the add_settings_section() function.
function bfr_section_olderthandate_cb( $args ) {
?>
<p id="<?php echo esc_attr( $args['id'] ); ?>">
<?php esc_html_e( 'Here you should set the options for the older content to be marked as it.', 'bfr_plugin_txtdomain' ); ?>
</p>
<?php
}
// daysback field cb
// field callbacks can accept an $args parameter, which is an array.
// $args is defined at the add_settings_field() function.
// wordpress has magic interaction with the following keys: label_for, class.
// the "label_for" key value is used for the "for" attribute of the <label>.
// the "class" key value is used for the "class" attribute of the <tr> containing the field.
// you can add custom key value pairs to be used inside your callbacks.
function bfr_field_olderthandate_cb( $args ) {
// get the value of the setting we've registered with register_setting()
$options = get_option( 'bfr_options' );
// output the field
?>
<p class="description">
<?php _e( 'You should set up the <b>number of days</b> from today to the past or the date from wich will be <b>considered old posts</b>. Then the class <span style="font-family:monospace;">oldpost</span> will be added to the post and pages so you can apply a css style to your theme.', 'bfr_plugin_txtdomain' ); ?>
</p>
<form id="bfr-oldpost-numberofdays" class="bfr-oldpost-numberofdays">
<label for="bfr-oldpost-numberofdays">Number of days:</label>
<input type="number" id="bfr-oldpost-numberofdays" name="bfr-oldpost-numberofdays" min="1" max="100">
</form>
<form id="bfr-oldpost-enddate" class="bfr-oldpost-enddate">
<label for="bfr-oldpost-enddate">Start date:</label>
<input type="date" id="bfr-oldpost-enddate" name="bfr-oldpost-endate" value="">
</form>
<!-- borrar desde aqui -->
<p>
label_for:<?php echo esc_attr( $args['label_for'] ); ?>
<br />
bfr_custom_data:<?php echo esc_attr( $args['bfr_custom_data'] ); ?>
<br />
class:<?php echo esc_attr( $args['class'] ); ?>
<br />
<?php esc_html_e( 'daysback', 'bfr_plugin_txtdomain' ); ?>
<br />
</p>
<!-- borrar hasta aqui -->
<?php
}
/**
* top level menu
* https://developer.wordpress.org/reference/functions/add_menu_page/
*/
function bfr_options_page() {
// add top level menu page
add_menu_page(
$page_title = 'Biofriction Options', // $page_title
$menu_title = 'Biofriction', //$menu_title
$capability = 'manage_options', //'edit_others_posts', // $capability
$menu_slug = 'biofriction-options', // $menu_slug
$function = 'bfr_options_page_html', //$function
$icon_url = 'dashicons-rest-api',// $icon_url //https://developer.wordpress.org/resource/dashicons/#menu
$position = '50'// $position
);
}
/**
* register our bfr_options_page to the admin_menu action hook
*/
add_action( 'admin_menu', 'bfr_options_page' );
/**
* top level menu:
* callback functions
*/
function bfr_options_page_html() {
// check user capabilities
if ( ! current_user_can( 'manage_options' ) ) {
?>
<p class="description">
<?php esc_html_e( 'Sorry, you do not have permission to edit this settings, please, contact any admin to get granted.', 'bfr_plugin_txtdomain' ); ?>
</p>
<?php
return;
}
// add error/update messages
// check if the user have submitted the settings
// wordpress will add the "settings-updated" $_GET parameter to the url
if ( isset( $_GET['settings-updated'] ) ) {
// add settings saved message with the class of "updated"
add_settings_error( 'bfr_messages', 'bfr_message', __( 'Settings Saved', 'bfr_plugin_txtdomain' ), 'updated' );
}
// show error/update messages
settings_errors( 'bfr_messages' );
?>
<div class="wrap">
<h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
<form action="options.php" method="post">
<?php
// output security fields for the registered setting "bfr"
settings_fields( 'bfr_settings' );
// output setting sections and their fields
// (sections are registered for "bfr", each field is registered to a specific section)
do_settings_sections( 'bfr_settings' );
// output save settings button
submit_button( 'Save Settings' );
?>
</form>
</div>
<?php
}