Skip to content

themingisprose/wasp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CodeFactor

WASP 🐝 • Woew! Another starter plugin

Introducción

WASP es un starter plugin que facilita el desarrollo con WordPress. Con él podrás crear tus propios plugins de manera rápida, fácil y sencilla. WASP Puede ser usado como framework para crear Custom Post Types, Taxonomías, Meta Boxes, Páginas de administración, Terms Meta, Users Meta, etc.

WASP provee un conjunto de clases a las que solo le debes pasar un grupo de parámetros para crear los elementos que componen tu plugin.

Tan fácil como:

<?php
use WASP\Posts\Post_Type;

class My_Plugin_Custom_Post_Type extends Post_Type
{
	function __construct()
	{
		parent::__construct();

		// CPT slug
		$this->post_type = 'my-cpt-slug';

		// CPT labels
		$this->labels = array( ... );

		// CPT arguments
		$this->args = array( ... );
	}
}
new My_Plugin_Custom_Post_Type;

Instalación

Manual

WASP se instala como cualquier otro plugin de WordPress, para ello debes descargar la última versión, descompactar el archivo .zip y copiar su contenido en el directorio wp-content/plugins/ de tu instalación de WordPress. O subirlo usando el instalador de plugins de WordPress.

Instalar vía Git

Puedes clonar este repositorio directamente desde GitHub.

$ cd /path/to/your/wordpress-site/wp-content/plugins/
$ git clone git@github.com:themingisprose/wasp.git

Modo de uso

Puedes usar este plugin de dos maneras:

Plantilla

Puedes generar tu propio repositorio a partir de este y usarlo como un template, solo debes pulsar el botón Use this template que aparece en el encabezado de este repositorio.

Es recomendable; pero no obligatorio, cambiar algunas cosas para una mayor facilidad a la hora de trabajar:

  1. Namespace: Buscar WASP\ y reemplazar por Your_Namespace\.
  2. Prefijo de funciones: Buscar wasp_ y reemplazar por your_function_prefix_.
  3. Text domain: Buscar 'wasp' (entre comillas simples) y reemplazar por 'your-text-domain'.
  4. Slug: Buscar wasp- y reemplazar por your-slug-.
  5. Comentarios y documentación: Buscar WASP y reemplazar por Your project name.
  6. Archivos: Buscar todos los archivos dentro del directorio /classes y cambiar el slug de cada uno por el que se ha especificado en el paso 4. Ej: class-wasp-admin-page.php por class-your-slug-admin-page.php. Hacer lo mismo con el archivo wasp.phpen la raíz del plugin.
  7. Editar la cabecera del plugin según sea necesario.

Es importante seguir estos pasos en el mismo orden que se muestran.

Child Plugin

Yes, a Child Plugin!

Puedes desarrollar tu propio plugin y heredar a todas las funcionalidades que brinda WASP creando un Child Plugin.

<?php
/**
 * Plugin Name: WASP Child 🐝
 * Description: Wow! Another starter "Child" plugin
 * Plugin URI: https://github.com/themingisprose/wasp
 * Author: RogerTM
 * Author URI: https://rogertm.com
 * Version: 1.0.0
 * License: GPL2
 * Text Domain: wasp-child
 * Domain Path: /languages
 */

// If this file is called directly, abort.
if ( ! defined( 'WPINC' ) )
    die;

if ( file_exists( WP_PLUGIN_DIR .'/wasp/wasp.php' ) )
	require WP_PLUGIN_DIR .'/wasp/wasp.php';
else
	wp_die( __( 'This plugin requires WASP', 'wasp-child' ), __( 'Bum! 💣', 'wasp-child' ) );

/** Your code goes here 😎 */

Documentación

Puedes ver todos los detalles referentes al uso de WASP en la Wiki de este mismo repositorio 👉 https://github.com/themingisprose/wasp/wiki

Licencia

WASP es un programa de código abierto y se distribuye bajo licencia GNU General Public License v2.0.

Happy coding!