Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaelnabil230/laravel-query-conditions
A UI component and BackEnd for building complex queries with nested conditionals.
https://github.com/michaelnabil230/laravel-query-conditions
laravel php tailwindcss vue
Last synced: about 1 month ago
JSON representation
A UI component and BackEnd for building complex queries with nested conditionals.
- Host: GitHub
- URL: https://github.com/michaelnabil230/laravel-query-conditions
- Owner: michaelnabil230
- License: mit
- Created: 2022-06-23T20:48:28.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-10-09T04:43:55.000Z (about 1 year ago)
- Last Synced: 2024-05-02T02:21:44.470Z (8 months ago)
- Topics: laravel, php, tailwindcss, vue
- Language: JavaScript
- Homepage:
- Size: 942 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# This is my package laravel-query-conditions
[](https://packagist.org/packages/michaelnabil230/laravel-query-conditions)
[](https://github.com/michaelnabil230/laravel-query-conditions/actions?query=workflow%3Arun-tests+branch%3Amain)
[](https://github.com/michaelnabil230/laravel-query-conditions/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain)
[](https://packagist.org/packages/michaelnabil230/laravel-query-conditions)
This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.
## Installation
You can install the package via composer:
```bash
composer require michaelnabil230/laravel-query-conditions
```
## Preparing your model
To associate query condonation with a model, the model must implement the following interface and trait:
```php
use Illuminate\Database\Eloquent\Model;
use MichaelNabil230\QueryConditions\Support\Condition;
use MichaelNabil230\QueryConditions\Concerns\HasQueryCondonation;
use MichaelNabil230\QueryConditions\Interfaces\QueryCondonation as InterfacesQueryCondonation;
use Illuminate\Database\Eloquent\Builder;
class YourModel extends Model implements InterfacesQueryCondonation
{
use HasQueryCondonation;
public function parseQBRule(Builder $query, Condition $condition, string $method): void
{
if ($condition->rule === 'age') {
$query->{$method}('age', $condition->operator, $condition->value);
}
if ($condition->rule === 'created_at') {
$query->{$method}('created_at', $condition->operator, $condition->value);
}
}
}
```
## Preparing Vue
```js
import './bootstrap';
window.Vue = require('vue').default;
import QueryBuilder from './components/QueryBuilder.vue'
const app = new Vue({
el: '#app',
components: { QueryBuilder },
methods: {
getResults: function () {
axios.post('/results', { query: this.query }).then(response => {
this.results = response.data;
console.log({ response });
});
}
},
data() {
return {
query: {},
rules: [
{
type: "numeric",
id: "age",
label: "Age"
},
{
type: "select",
id: "job_title",
label: "Job Title",
choices: [
{ label: 'Regional Manager', value: 'Regional Manager' },
{ label: 'Assistant to the Regional Manager', value: 'Assistant to the Regional Manager' },
{ label: 'Sales Associate', value: 'Sales Associate' },
]
},
{
type: "numeric",
id: "has_orders",
label: "has Orders",
operators: ['=', '>=']
},
],
};
}
});
```
First call the directive in blade or vue (and pass condonations):
## Now
```html
```
## The next version
```php
$condonations = [
Text::make('Name'),
Number::make('Age')->min(1)->max(1000),
Select::make('Job title', 'job_title')->options([
'R' => 'Regional Manager',
'A' => 'Assistant to the Regional Manager',
'S' => 'Sales Associate',
])
];
```
```html
let condonations = @json($condonations)
```
## Final go to controller
```php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use MichaelNabil230\QueryConditions\QueryConditions;
use App\Models\User;
class ConditionController extends Controller
{
public function getDataFromQueryConditions(Request $request)
{
$users = QueryConditions::for(User::class, $request->input('query'))
->get();
return [
'users' => $users,
];
}
}
```
## Some screenshots of the package it is a best package
## TODOS
- [ ] Format the documents
- [ ] Add groupe in to conditions
- [ ] Test a complicated query
- [ ] Implement `Fields` classes in to FrontEnd
- [ ] Add unit tests
## Testing
```bash
composer test
```
## Support
[](https://ko-fi.com/michaelnabil230)[](https://www.buymeacoffee.com/michaelnabil230)[](https://www.paypal.com/paypalme/MichaelNabil23)
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.
## Security Vulnerabilities
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
## Credits
- [Michael Nabil](https://github.com/michaelnabil230)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.