Title: NinjaDB Author: Shahjahan Jewel Published: September 26, 2017 Last modified: September 26, 2017 --- Search plugins ![](https://ps.w.org/ninjadb/assets/banner-772x250.png?rev=1736466) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/ninjadb/assets/icon-256x256.png?rev=1736466) # NinjaDB By [Shahjahan Jewel](https://profiles.wordpress.org/techjewel/) [Download](https://downloads.wordpress.org/plugin/ninjadb.zip) * [Details](https://wordpress.org/plugins/ninjadb/#description) * [Reviews](https://wordpress.org/plugins/ninjadb/#reviews) * [Installation](https://wordpress.org/plugins/ninjadb/#installation) * [Development](https://wordpress.org/plugins/ninjadb/#developers) [Support](https://wordpress.org/support/plugin/ninjadb/) ## Description A lightweight, expressive query builder for WordPress. NInjaDB use the same `$wbdp` instance and methods, It will help you to write $wpdb queries easily and expressively. At least PHP 5.3 is required. It has some advanced features like: – Query Like Laravel Basic Queries – Where, orWhere methods – Search data in all the columns or specific columns – Easily Implement Pagination – use insert, update or delete methods expressively. The syntax is quite similar to Laravel’s query builder. **Simple Query:** The query below returns the row where id = 3, null if no rows. ``` $row = ninjaDB('my_table')->find(3); ``` **Full Queries:** ``` $query = ninjaDB('my_table')->where('post_author', '=', 1); // for equal you can just use where('post_author, 1); // Get result as array of objects $query->get(); ``` ### Full Usage API ### Initiate ``` // Select a table $query = ninjaDB()->table('post'); // post is the table name without prefix; ``` **OR You can pass your table name as an argument** ``` // Select a table $query = ninjaDB('my_table'); // post is the table name without prefix;

Query

``` ### Get Easily The query below returns the (first) row where id = 3, null if no rows. ``` $row = ninjaDB('my_table')->find(3); ``` Access your row like, `echo $row->name`. If your field name is not `id` then pass the field name as second parameter `ninjaDB('my_table')->find(3, 'author_id');`. The query below returns the all rows as array of objects where author_id = 3, null if no rows. ``` $result = ninjaDB('my_table')->findAll('author_id', 3); ``` ### Select ``` $query = ninjaDB('my_table')->select('*'); ``` #### Multiple Selects ``` ->select(array('myfield1', 'myfield2', 'amyfield3')); ``` Using select method multiple times `select('a')->select('b')` will also select ` a` and `b`. Can be useful if you want to do conditional selects (within a PHP `if`). #### Get All Return an array of objects. ``` $query = ninjaDB('my_table')->where('author_id', 1); $result = $query->get(); ``` You can loop through it like: ``` foreach ($result as $row) { echo $row->name; } ``` #### Get First Row ``` $query = ninjaDB('my_table')->where('author_id', 1); $row = $query->first(); ``` Returns the first row, or null if there is no record. Using this method you can also make sure if a record exists. Access these like `echo $row->name`. #### Get Rows Count, MAX, MIN, AVerage, SUM ``` $query = ninjaDB('my_table')->where('author_id', 1); $count = $query->count(); $max = $query->max('views'); // Where `views` is the column name and all these will return integer / float $min = $query->min('views'); $avg = $query->avg('views'); $avg = $query->avg('views'); $sum = $query->sum('views'); ``` ### Where Basic syntax is `(fieldname, operator, value)`, if you give two parameters then ` =` operator is assumed. So `where('name', 'jewel')` and `where('name', '=', 'jewel')` is the same. ``` ninjaDB('my_table') ->where('name', '=', 'jewel') ->whereNot('age', '>', 25) ->orWhere('description', 'LIKE', '%query%'); ``` ### whereIn ``` ninjaDB('my_table') ->whereIn( 'id', array(1,2,3) ) ->get(); ``` ### Limit and Offset ``` ->limit(30); ->offset(10); // or you can use aliases ->take(30); ->skip(10); ``` ### Order By ``` ->orderBy('id', 'ASC'); ``` ### Insert ``` $data = array( 'name' => 'Jewel', 'description' => 'Hello, There' ); $insertId = ninjaDB('my_table')->insert($data); insert() method returns the insert id. optionally you can pass $format of your data as `->insert($data, $format);` where `$format` is an array of formats to be mapped to each of the value in $data ``` #### Batch Insert ``` $data = array( array( 'name' => 'Jewel', 'description' => 'Hello, There' ), array( 'name' => 'Adre', 'description' => 'Hello, I am Adre Astrian' ), ); $insertIds = ninjaDB('my_table')->batch_insert($data); ``` In case of batch insert, it will return an array of insert ids. ### Update ``` $data = array( 'name' => 'Shahjahan Jewel', 'description' => 'Hello, There' ); ninjaDB('my_table')->where('id', 5)->update($data); ``` Will update the name field to `Shahjahan Jewel` and description field to `Hello, There` where `id = 5`. ### Delete ``` ninjaDB('my_table')->where('id', '>', 5)->delete(); ``` Will delete all the rows where id is greater than 5. If you find any typo or extend any functionality then please edit and send a pull request. ### TODO * [ ] join() * [x] whereIN() * [ ] whereNotIN() * [ ] whereBetween * [ ] whereNotBetween * [ ] Having * [ ] GroupBy * [x] selectDistinct _If you would like to implement any of the TODO please feel free to do and do a pull request_ And, finally, consider to contribute to this plugin [here](https://github.com/WpManageNinja/NinjaDB). ## Installation In the search field type “NinjaDB” and click Search Plugins. Once you’ve found this plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”. ## FAQ Installation Instructions In the search field type “NinjaDB” and click Search Plugins. Once you’ve found this plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”. Where can I find documentation and user guides? For Expressive Documentation please [follow github repo](https://github.com/WpManageNinja/NinjaDB) ## Reviews There are no reviews for this plugin. ## Contributors & Developers “NinjaDB” is open source software. The following people have contributed to this plugin. Contributors * [ Shahjahan Jewel ](https://profiles.wordpress.org/techjewel/) * [ Mahmudul Hasan Arif ](https://profiles.wordpress.org/adreastrian/) [Translate “NinjaDB” into your language.](https://translate.wordpress.org/projects/wp-plugins/ninjadb) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/ninjadb/), check out the [SVN repository](https://plugins.svn.wordpress.org/ninjadb/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ninjadb/) by [RSS](https://plugins.trac.wordpress.org/log/ninjadb/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.8 – 2017-09-10 * Initial Release ## Meta * Version **0.8** * Last updated **9 years ago** * Active installations **Fewer than 10** * WordPress version ** 4.0 or higher ** * Tested up to **4.8.28** * [Advanced View](https://wordpress.org/plugins/ninjadb/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/ninjadb/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/ninjadb/reviews/) ## Contributors * [ Shahjahan Jewel ](https://profiles.wordpress.org/techjewel/) * [ Mahmudul Hasan Arif ](https://profiles.wordpress.org/adreastrian/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/ninjadb/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://paypal.me/zalam)