OSCLASS PLUGIN TUTORIAL
\n1. Create a new directory in any directory. name it ‘my_firstplugin’.
\n2. Create a new file in the directory. name it ‘index.php’.
\n3. open the file and add these lines in it :
\n\/*
\nPlugin Name: My First Plugin
\nShort Name: my_firstplugin
\nPlugin URI: –
\nDescription: A first osclass plugin for tutorial purpopse.
\nVersion: 1.00
\nAuthor: Satria
\nAuthor URI: –
\n*\/
\nabove is ‘plugin info’
\n4. to make the plugin installable, add this function : osc_register_plugin. so<\/p>\n
\/**
\n* (hook: install) Make installation operations
\n* \u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0It creates the database schema and sets some preferences.
\n* @returns void.
\n*\/
\nfunction my_firstplugin_install() {<\/p>\n
}
\nosc_register_plugin(osc_plugin_path(__FILE__), ‘my_firstplugin_install’);<\/p>\n
then add two hooks to initialize (load\/init) the plugin and to uninstall the plugin, respectively :<\/p>\n
\/**
\n* (hook: init) Registers scripts and styles.
\n* @returns void.
\n*\/
\nfunction my_firstplugin_load() {<\/p>\n
}
\nosc_add_hook(‘init’, ‘my_firstplugin_load’);<\/p>\n
\/**
\n* (hook: uninstall) Make un-installation operations
\n* \u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0It destroys the database schema and unsets some preferences.
\n* @returns void.
\n*\/
\nfunction my_firstplugin_uninstall() {<\/p>\n
}
\nosc_add_hook(osc_plugin_path(__FILE__) . ‘_uninstall’, ‘my_firstplugin_uninstall’);<\/p>\n
5. those are the minimum requirement (install, uninstall and load) to create an osclass plugin. Zip the directory (so it’ll be my_firstplugin.zip) then open the oc-admin page and add the plugin from the zip file.
\nif there is an error “There was a problem adding the plugin” when installing the plugin then just copy and paste the plugin directory in oc-content\/plugins\/ directory<\/p>\n
6. From admin page, we can install\/uninstall and enable\/disable our plugin but this plugin dont have any functionality yet. we will add some scripts so we can display the links\/menu in admin page to configure the plugin. In the index.php file, add this hook ‘admin_menu’ so it’ll be :
\n\/**
\n* (hook: admin_menu) Display the admin menu
\n* @returns html.
\n*\/
\nfunction my_firstplugin_admin_menu() {
\necho ‘<h3><a href=”#”>My First Plugin<\/a><\/h3>
\n<ul>
\n<li><a href=”‘ . osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link1.php’) . ‘”>» ‘ . __(‘Link 1’, ‘my_firstplugin’) . ‘<\/a><li>
\n<li><a href=”‘ . osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link2.php’) . ‘”>» ‘ . __(‘Link 2’, ‘my_firstplugin’) . ‘<\/a><\/li>
\n<\/ul>’;
\n}
\nosc_add_hook(‘admin_menu’, ‘my_firstplugin_admin_menu’);<\/p>\n
EDIT : if we have osclass version higher than 320 then we better to edit the above function like this :
\n\/**
\n* (hook: admin_menu) Display the admin menu
\n* @returns html.
\n*\/
\nfunction my_firstplugin_admin_menu() {
\nif(osc_version()<320) {
\necho ‘<h3><a href=”#”>My First Plugin<\/a><\/h3>
\n<ul>
\n<li><a href=”‘ . osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link1.php’) . ‘”>» ‘ . __(‘Link 1’, ‘my_firstplugin’) . ‘<\/a><li>
\n<li><a href=”‘ . osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link2.php’) . ‘”>» ‘ . __(‘Link 2’, ‘my_firstplugin’) . ‘<\/a><\/li>
\n<\/ul>’;
\n}else{
\nosc_add_admin_submenu_divider(‘plugins’, __(‘My First Plugin’, ‘my_firstplugin’), ‘my_firstplugin_divider’, ‘administrator’);
\nosc_add_admin_submenu_page(‘plugins’, ‘» ‘.__(‘Link 1’, ‘my_firstplugin’), osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link1.php’), ‘my_firstplugin_link1’, ‘administrator’);
\nosc_add_admin_submenu_page(‘plugins’, ‘» ‘.__(‘Link 2’, ‘my_firstplugin’), osc_admin_render_plugin_url(osc_plugin_folder(__FILE__) . ‘\/admin\/link2.php’), ‘my_firstplugin_link2’, ‘administrator’);
\n}
\n}
\n\/\/osc_add_hook(‘admin_menu’, ‘my_firstplugin_admin_menu’);
\nif(osc_version()<320) {
\nosc_add_hook(‘admin_menu’, ‘my_firstplugin_admin_menu’);
\n} else {
\nosc_add_hook(‘admin_menu_init’, ‘my_firstplugin_admin_menu’);
\n}<\/p>\n
dont forget to add a new directory ‘admin’ in the plugin. then add two new files in it : link1.php and link2.php. the files will display the html content. you can add any html file in its.<\/p>\n
7. Ok. great. then how to add any content on the front page by our plugin? Without any plugin we can add any content in oc-content\/themes\/your-theme\/main.php. ‘your-theme’ is curent activated theme, it could be ‘bender’ (default theme). we can insert any html\/php code in main.php file like <p>TEST<\/p> or <?php echo “Great”; ?>. If we want to make it better, we can include any php\/html file and add this code <?php osc_current_web_theme_path(‘your_file.php’) ; ?> dont forget to add the new file your_file.php and fill it with any html\/php code.<\/p>\n
8. Ok. now we want to connect to database and pull some data to be displayed in the admin page.
\nin index.php file below the plugin info, add a line :
\nrequire_once ‘model\/myfirstplugin_model.php’;
\nthen add a new directory ‘model’ and a file ‘myfirstplugin_model.php’ in it.
\nwe want to display all city in a table t_city on link1.php file. so add these lines in myfirstplugin_model.php file :
\n<?php<\/p>\n
\/**
\n* Data Access Object (DAO) for messages.
\n*\u00a0\u00a0 \u00a0Performs operations on database.
\n* @author Satria
\n* @package my_firstplugin
\n* @subpackage Model
\n* @since 1.00
\n*\/
\nclass MyFirstPluginModel extends DAO {<\/p>\n
function __construct() {
\nparent::__construct();
\n}<\/p>\n
\/**
\n* Singleton.
\n*\/
\nprivate static $instance;<\/p>\n
\/**
\n* Singleton constructor.
\n* @return an MadhouseMessengerDAO object.
\n*\/
\npublic static function newInstance() {
\nif(!self::$instance instanceof self) {
\nself::$instance = new self;
\n}
\nreturn self::$instance;
\n}<\/p>\n
\/**
\n* Return table name city
\n* @return string
\n*\/
\npublic function getTable_City()
\n{
\nreturn DB_TABLE_PREFIX.’t_city’;
\n}<\/p>\n
\/**
\n* Get all city
\n*
\n* @return array
\n*\/
\npublic function getAllCity()
\n{
\n$this->dao->select();
\n$this->dao->from( $this->getTable_City() ) ;
\n$this->dao->orderBy(‘s_name’, ‘ASC’) ;<\/p>\n
$results = $this->dao->get();
\nif( !$results ) {
\nreturn array() ;
\n}<\/p>\n
return $results->result();
\n}
\n}<\/p>\n
then edit link1.php file so it’ll be :<\/p>\n
<div id=”settings_form” style=”border: 1px solid #ccc; background: #eee; “>
\n<div style=”padding: 20px;”>
\n<div>
\n<fieldset>
\n<legend><?php _e(‘My First Plugin Link 1 : All City Name’); ?><\/legend>
\n<!–p>
\n<?php _e(‘Congratulation. This is a link 1 content’, ‘my_firstplugin’); ?>
\n<\/p–>
\n<?php
\n$city = MyFirstPluginModel::newInstance()->getAllCity();
\nforeach($city as $c){
\necho $c[‘s_name’].'<br>’;
\n}
\n?>
\n<p>
\n<?php _e(‘Created by Satria Faestha. Osclass version : ‘.osc_version(), ‘my_firstplugin ‘); ?>
\n<\/p>
\n<\/fieldset>
\n<\/div>
\n<\/div>
\n<\/div><\/p>\n
then open link1.php on admin page. All city name will be displayed on the page.
\nYou can play with the query like just show 5 top city, etc.<\/p>\n
9. Now we want to add our own table so when we install the plugin, our table will be created and ready to be used. otherwise if we want to uninstall the plugin, the tables will be deleted.
\nAdd these two sql file in sql directory (create a new directory ‘sql’). they are myfirstplugin.sql and add_data.sql
\nin myfirstplugin.sql :
\nCREATE TABLE \/*TABLE_PREFIX*\/t_my_firstplugin (
\npk_i_id INT(2) UNSIGNED NOT NULL AUTO_INCREMENT,
\ns_name VARCHAR(255),<\/p>\n
PRIMARY KEY (pk_i_id)
\n) ENGINE=InnoDB DEFAULT CHARACTER SET ‘UTF8’ COLLATE ‘UTF8_GENERAL_CI’;<\/p>\n
in add_data.sql :
\nINSERT INTO \/*TABLE_PREFIX*\/t_my_firstplugin (pk_i_id, s_name) VALUES (1,’Satria Faestha’);
\nINSERT INTO \/*TABLE_PREFIX*\/t_my_firstplugin (pk_i_id, s_name) VALUES (2,’Ermillya Roza’);
\nINSERT INTO \/*TABLE_PREFIX*\/t_my_firstplugin (pk_i_id, s_name) VALUES (3,’Sarah Almahyrah’);
\nINSERT INTO \/*TABLE_PREFIX*\/t_my_firstplugin (pk_i_id, s_name) VALUES (4,’Alim Alhikmah’);<\/p>\n
in myfirstplugin_model.php add these lines :
\n\/**
\n* Import sql file
\n* @param type $file
\n*\/
\npublic function import($file)
\n{
\n$path = osc_plugin_resource($file) ;
\n$sql = file_get_contents($path);<\/p>\n
if(! $this->dao->importSQL($sql) ){
\nthrow new Exception( “Error importSQL::MyFirstPluginModel<br>”.$file ) ;
\n}
\n}
\n\/**
\n* Remove data and tables related to the plugin.
\n*\/
\npublic function uninstall()
\n{
\n$this->dao->query(sprintf(‘DROP TABLE ‘.DB_TABLE_PREFIX.’t_my_firstplugin’) ) ;
\n}<\/p>\n
then in index.php file edit these functions :
\nfunction my_firstplugin_install() {
\nMyFirstPluginModel::newInstance()->import(‘my_firstplugin\/sql\/myfirstplugin.sql’);
\nMyFirstPluginModel::newInstance()->import(‘my_firstplugin\/sql\/add_data.sql’);
\n}
\nosc_register_plugin(osc_plugin_path(__FILE__), ‘my_firstplugin_install’);<\/p>\n
and<\/p>\n
function my_firstplugin_uninstall() {
\nMyFirstPluginModel::newInstance()->uninstall();
\n}
\nosc_add_hook(osc_plugin_path(__FILE__) . ‘_uninstall’, ‘my_firstplugin_uninstall’);<\/p>\n
then do uninstall (if our plugin still installed) and install the plugin. you can see the new table t_my_firstplugin in our database. you can add new function in the model file to pull the content :
\npublic function getMyFirstPluginData()
\n{
\n$this->dao->select();
\n$this->dao->from( $this->getTable_MyFirstPlugin() ) ;
\n\/\/$this->dao->orderBy(‘s_name’, ‘ASC’) ;
\n$this->dao->orderBy(‘pk_i_id’, ‘ASC’) ;<\/p>\n
$results = $this->dao->get();
\nif( !$results ) {
\nreturn array() ;
\n}<\/p>\n
return $results->result();
\n}<\/p>\n
then in link2.php file, edit the content so it’ll be :
\n<div id=”settings_form” style=”border: 1px solid #ccc; background: #eee; “>
\n<div style=”padding: 20px;”>
\n<div>
\n<fieldset>
\n<legend><?php _e(‘My First Plugin Link 2’); ?><\/legend>
\n<p>
\n<?php
\n$data = MyFirstPluginModel::newInstance()->getMyFirstPluginData();
\nforeach($data as $d){
\necho $d[‘s_name’].'<br>’;
\n}
\n?>
\n<\/p>
\n<\/fieldset>
\n<\/div>
\n<\/div>
\n<\/div><\/p>\n
10. We also want the data in our table can be added, edited and\/or deleted.<\/p>\n","protected":false},"excerpt":{"rendered":"
OSCLASS PLUGIN TUTORIAL 1. Create a new directory in any directory. name it ‘my_firstplugin’. 2. Create a new file in the directory. name it ‘index.php’. 3. open the file and add these lines in it : \/* Plugin Name: My First Plugin Short Name: my_firstplugin Plugin URI: – Description: A first osclass plugin for tutorial … Continue reading “OSClass First Plugin Tutorial”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36,13],"tags":[],"class_list":["post-735","post","type-post","status-publish","format-standard","hentry","category-osclass","category-tutorial"],"_links":{"self":[{"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/posts\/735","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/comments?post=735"}],"version-history":[{"count":1,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/posts\/735\/revisions"}],"predecessor-version":[{"id":736,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/posts\/735\/revisions\/736"}],"wp:attachment":[{"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/media?parent=735"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/categories?post=735"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/myprojects.advchaweb.com\/index.php\/wp-json\/wp\/v2\/tags?post=735"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}