Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/webwizo/laravel-shortcodes

Wordpress like shortcodes for Laravel 4.2, 5.x, 6.x, 7.x, 8.x, 9.x and 10.x
https://github.com/webwizo/laravel-shortcodes

laravel shortcode wordpress

Last synced: 8 days ago
JSON representation

Wordpress like shortcodes for Laravel 4.2, 5.x, 6.x, 7.x, 8.x, 9.x and 10.x

Host: GitHub
URL: https://github.com/webwizo/laravel-shortcodes
Owner: webwizo
License: mit
Created: 2016-05-23T18:13:35.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-03-18T14:41:49.000Z (8 months ago)
Last Synced: 2024-05-17T09:42:26.834Z (6 months ago)
Topics: laravel, shortcode, wordpress
Language: PHP
Homepage:
Size: 62.5 KB
Stars: 206
Watchers: 9
Forks: 49
Open Issues: 18
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # Laravel-Shortcodes

[![Latest Version on Packagist][ico-version]][link-packagist]

[![Software License][ico-license]](LICENSE.md)

[![Build Status][ico-travis]][link-travis]

[![Coverage Status][ico-scrutinizer]][link-scrutinizer]

[![Quality Score][ico-code-quality]][link-code-quality]

[![Total Downloads][ico-downloads]][link-downloads]

[![StyleCI](https://styleci.io/repos/59507292/shield)](https://styleci.io/repos/59507292)

WordPress like shortcodes for Laravel 5.x

```php

[b class="bold"]Bold text[/b]

[tabs]

  [tab]Tab 1[/tab]

  [tab]Tab 2[/tab]

[/tabs]

[user id="1" display="name"]

```

If you are looking for Laravel 4.2, see: https://github.com/patrickbrouwers/Laravel-Shortcodes

## Install

Via Composer

``` bash

$ composer require "webwizo/laravel-shortcodes:1.0.*"

```

After updating composer, add the ServiceProvider to the providers array in `config/app.php`

## Usage

```php

Webwizo\Shortcodes\ShortcodesServiceProvider::class,

```

You can use the facade for shorter code. Add this to your aliases:

```php

'Shortcode' => Webwizo\Shortcodes\Facades\Shortcode::class,

```

The class is bound to the ioC as `shortcode`

```php

$shortcode = app('shortcode');

```

# Usage

### withShortcodes()

To enable the view compiling features:

```php

return view('view')->withShortcodes();

```

This will enable shortcode rendering for that view only.

### Enable through class

```php

Shortcode::enable();

```

### Disable through class

```php

Shortcode::disable();

```

### Disabling some views from shortcode compiling

With the config set to true, you can disable the compiling per view.

```php

return view('view')->withoutShortcodes();

```

## Default compiling

To use default compiling:

```php

Shortcode::compile($contents);

```

### Strip shortcodes from rendered view.

```php

return view('view')->withStripShortcodes();

```

## Strip shortcode through class

```php

Shortcode::strip($contents);

```

## Registering new shortcodes

Create a new ServiceProvider where you can register all the shortcodes.

``` bash

php artisan make:provider ShortcodesServiceProvider

```

After defining shortcodes, add the ServiceProvider to the providers array in `config/app.php`

## Usage

```php

App\Providers\ShortcodesServiceProvider::class,

```

### Callback

Shortcodes can be registered within ShortcodesServiceProvider with a callback:

```bash

php artisan make:provider ShortcodesServiceProvider

```

ShortcodesServiceProvider.php Class File

```php

%s', $shortcode->class, $content);

  }

  

}

```

### Class with custom method

You can store each shortcode within their class `app/Shortcodes/ItalicShortcode.php`

```php

namespace App\Shortcodes;

class ItalicShortcode {

  public function custom($shortcode, $content, $compiler, $name, $viewData)

  {

    return sprintf('%s', $shortcode->class, $content);

  }

  

}

```

### Register helpers

If you only want to show the html attribute when the attribute is provided in the shortcode, you can use `$shortcode->get($attributeKey, $fallbackValue = null)`

```php

class BoldShortcode {

  public function register($shortcode, $content, $compiler, $name, $viewData)

  {

    return 'get('class', 'default') .'>' . $content . '';

  }

  

}

```

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.

## Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

## Credits

- [Asif Iqbal][link-author]

- [All Contributors][link-contributors]

## Support me



## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

[ico-version]: https://img.shields.io/packagist/v/webwizo/laravel-shortcodes.svg?style=flat-square

[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square

[ico-travis]: https://img.shields.io/travis/webwizo/laravel-shortcodes/master.svg?style=flat-square

[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/webwizo/laravel-shortcodes.svg?style=flat-square

[ico-code-quality]: https://img.shields.io/scrutinizer/g/webwizo/laravel-shortcodes.svg?style=flat-square

[ico-downloads]: https://img.shields.io/packagist/dt/webwizo/laravel-shortcodes.svg?style=flat-square

[link-packagist]: https://packagist.org/packages/webwizo/laravel-shortcodes

[link-travis]: https://travis-ci.org/webwizo/laravel-shortcodes

[link-scrutinizer]: https://scrutinizer-ci.com/g/webwizo/laravel-shortcodes/code-structure

[link-code-quality]: https://scrutinizer-ci.com/g/webwizo/laravel-shortcodes

[link-downloads]: https://packagist.org/packages/webwizo/laravel-shortcodes

[link-author]: https://github.com/webwizo

[link-contributors]: ../../contributors