PHPackages awcodes/richer-editor - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. awcodes/richer-editor ActiveLibrary awcodes/richer-editor ===================== A collection of extensions and tools to enhance the Filament Rich Editor field. v2.1.0(3mo ago)362.4k↓27.2%4[1 PRs](https://github.com/awcodes/richer-editor/pulls)2MITPHPPHP ^8.2CI passing Since Dec 9Pushed 1mo ago2 watchersCompare [ Source](https://github.com/awcodes/richer-editor)[ Packagist](https://packagist.org/packages/awcodes/richer-editor)[ Docs](https://github.com/awcodes/richer-editor)[ GitHub Sponsors](https://github.com/awcodes)[ RSS](/packages/awcodes-richer-editor/feed)WikiDiscussions 2.x Synced 1mo ago READMEChangelog (7)Dependencies (16)Versions (11)Used By (2) Richer Editor ============= [](#richer-editor) A collection of extensions and tools to enhance the Filament Rich Editor field. [![Latest Version](https://camo.githubusercontent.com/db98589932adcff2e74105a7c2d3f6fed877d477089b0598cd3ae0287d7df6e0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6177636f6465732f7269636865722d656469746f722e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d52656c65617365)](https://github.com/awcodes/richer-editor/releases)[![MIT Licensed](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/f9cb442ba4851b0eaef9653aeff09ac5929fd1d0a4339d4659b5975c618b4ce8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f7269636865722d656469746f722e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/awcodes/richer-editor)[![GitHub Repo stars](https://camo.githubusercontent.com/783800f1e10a8d6cb664f9296e4f90cb05bd78b40f718364e7c7fc1583bd55d9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6177636f6465732f7269636865722d656469746f723f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d5374617273)](https://github.com/awcodes/richer-editor/stargazers) Compatibility ------------- [](#compatibility) Package VersionFilament Version1.x4.x2.x5.xInstallation ------------ [](#installation) You can install the package via composer: ``` composer require awcodes/richer-editor ``` Important If you have not set up a custom theme and are using Filament Panels, follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first. After setting up a custom theme, add the plugin's CSS and views to your theme.css file or your app.css file if using the standalone packages. ``` @import '../../../../vendor/awcodes/richer-editor/resources/css/index.css'; @source '../../../../vendor/awcodes/richer-editor/resources/views/**/*.blade.php'; ``` Editor Usage ------------ [](#editor-usage) Warning The following plugins are experimental and should not be used at the moment. See their docblocks for more information. - CodeBlockLowlightPlugin - CodeBlockShikiPlugin - FigurePlugin - VideoPlugin ### Plugins [](#plugins) ``` use Awcodes\RicherEditor\Plugins\DebugPlugin; use Awcodes\RicherEditor\Plugins\EmbedPlugin; use Awcodes\RicherEditor\Plugins\EmojiPlugin; use Awcodes\RicherEditor\Plugins\FullScreenPlugin; use Awcodes\RicherEditor\Plugins\IdPlugin; use Awcodes\RicherEditor\Plugins\LinkPlugin; use Awcodes\RicherEditor\Plugins\SourceCodePlugin; use Awcodes\RicherEditor\Plugins\FakerPlugin; RichEditor::make('content') ->plugins([ DebugPlugin::make(), // only works in local environment EmbedPlugin::make(), EmojiPlugin::make(), // Doesn't have a toolbar button FullScreenPlugin::make(), IdPlugin::make(), // Doesn't have a toolbar button LinkPlugin::make(), // Requires IdPlugin SourceCodePlugin::make(), FakerPlugin::make(), // only works in local environment ]) ->toolbarButtons([ ['embed', 'sourceCode', 'fullscreen', 'debug', 'fakeHeading', 'fakeParagraphs', 'fakeBulletList', 'fakeNumberedList'], ]) ``` ### Max Height [](#max-height) ``` use Filament\Forms\Components\RichEditor\RichEditorTool; RichEditor::make('content') ->maxHeight('400px') ``` ### Nested Tool Groups (Dropdowns) [](#nested-tool-groups-dropdowns) ``` use Awcodes\RicherEditor\Tools\ToolGroup; use Filament\Forms\Components\RichEditor\RichEditorTool; RichEditor::make('content') ->tools([ ToolGroup::make('headingTools') ->label('Headings') ->icon(Heroicon::H1) ->displayAsLabel() ->items([ 'h1', 'h2', 'h3', RichEditorTool::make('h4')... ]), ToolGroup::make('devTools') ->label('Developer Tools') ->icon(Heroicon::Sparkles) ->displayAsLabel() ->items([ 'debug', 'fakeHeading', 'fakeParagraphs', 'fakeBulletList', 'fakeNumberedList' ]), ]) ->toolbarButtons([ ['headingTools', 'devTools'], ]) ``` ### Prebuilt Tools [](#prebuilt-tools) - Heading Four - Heading Five - Heading Six ``` use Awcodes\RicherEditor\Tools\HeadingFourTool; use Awcodes\RicherEditor\Tools\HeadingFiveTool; use Awcodes\RicherEditor\Tools\HeadingSixTool; RichEditor::make('content') ->tools([ HeadingFourTool::make(), HeadingFiveTool::make(), HeadingSixTool::make(), ]) ->toolbarButtons([ ['h4', 'h5', 'h6'], ]) ``` ### Prebuilt Blocks [](#prebuilt-blocks) #### Highlighted Code Block (Phiki) [](#highlighted-code-block-phiki) ``` use Awcodes\RicherEditor\Blocks\HighlightedCodeBlock; RichEditor::make('content') ->blocks([ HighlightedCodeBlock::class, ]) // when rendering the content, you can change the theme using any of Phiki's supported themes. See https://phiki.dev/multi-themes use Awcodes\RicherEditor\Blocks\HighlightedCodeBlock; use Phiki\Theme\Theme; RichContentRenderer::make($content) ->customBlocks([ HighlightedCodeBlock::class => [ 'light' => Theme::GithubLight, 'dark' => Theme::GithubDark, ], ]) ->toHtml() ``` Rendering Usage --------------- [](#rendering-usage) ### Rendering Headings as links [](#rendering-headings-as-links) ``` use Filament\Forms\Components\RichEditor\RichContentRenderer; RichContentRenderer::make($content) ->linkHeadings(level: 3, wrap: false) ->toHtml() ``` ### Rendering as Markdown [](#rendering-as-markdown) This feature uses [HTML To Markdown for PHP](https://github.com/thephpleague/html-to-markdown) by [thephpleague](https://github.com/thephpleague). Please see their documentation for available options. ``` use Filament\Forms\Components\RichEditor\RichContentRenderer; RichContentRenderer::make($content) ->toMarkdown(options: []) ``` ### Rendering native code blocks with Phiki syntax highlighting. [](#rendering-native-code-blocks-with-phiki-syntax-highlighting) Caution This should **NOT** be used globally as it will not work with Filament's rich content attributes when storing/reading content in the database when in a form context. ``` use Awcodes\RicherEditor\Support\RichContentRenderer; use Awcodes\RicherEditor\Plugins\PhikiCodeBlockPlugin; RichContentRenderer::make($content) ->plugins([ PhikiCodeBlockPlugin::make(), ]) ->phikiCodeBlocks() ->toHtml(); ``` ### Rendering Table of Contents [](#rendering-table-of-contents) ``` use Awcodes\RicherEditor\Support\TableOfContents; TableOfContents::make($content) ->asHtml(); /** or as an array to handle the output yourself */ $toc = TableOfContents::make($content) ->asArray(); ``` Utilities --------- [](#utilities) ### Rich Content Faker [](#rich-content-faker) ``` use Awcodes\RicherEditor\Support\RichContentFaker; $richContent = RichContentFaker::make() ->heading(level: 2) ->paragraphs( count: 1, links: false, code: false, bold: false, italic: false, underline: false, strike: false, subscript: false, superscript: false, mergeTags: [], highlight: false ) ->lead(pargraphs: 1, links: false) ->small(pargraphs: 1, links: false) ->list(count: 3, links: false, ordered: false) ->image(source: null, width: 1280, height: 720) ->details(open: false, links: false) ->code(className: 'language-php') ->codeBlock(language: 'sh', prefix: 'language-') ->blockquote() ->hr() ->br() ->table(cols: null) ->grid(cols: [1,1,1], breakpoint: 'md') ->customBlock( id: 'batman', config: [ 'name' => 'Batman', 'color' => 'black', 'side' => 'hero' ] ) ->emptyParagraph() // rendering (only use one) ->asHtml() ->asJson() ->asText(); ``` Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Adam Weston](https://github.com/awcodes) - [The League of Extraordinary Packages](https://github.com/thephpleague) - [Phiki](https://github.com/phikiphp/phiki) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 51 — FairBetter than 96% of packages Maintenance86 Actively maintained with recent releases Popularity35 Limited adoption so far Community19 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Total 9 Last Release 68d ago Major Versions v1.1.1 → v2.0.02026-01-19 v1.2.1 → v2.1.02026-02-05 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes) --- Top Contributors [![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (41 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![diegoldev](https://avatars.githubusercontent.com/u/1553775?v=4)](https://github.com/diegoldev "diegoldev (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags filamentfilament-pluginlaravelfilamentfilamentphpawcodesricher-editor ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/awcodes-richer-editor/health.svg) ``` [![Health](https://phpackages.com/badges/awcodes-richer-editor/health.svg)](https://phpackages.com/packages/awcodes-richer-editor) ``` ### Alternatives [awcodes/filament-table-repeater A modified version of the Filament Forms Repeater to display it as a table. 262815.1k5](/packages/awcodes-filament-table-repeater)[dotswan/filament-map-picker Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications. 124139.3k2](/packages/dotswan-filament-map-picker)[joshembling/image-optimizer Optimize your Filament images before they reach your database. 111145.4k12](/packages/joshembling-image-optimizer)[defstudio/filament-searchable-input A searchable autocomplete input for Filament forms 3212.4k](/packages/defstudio-filament-searchable-input)[relaticle/custom-fields User Defined Custom Fields for Laravel Filament 15828.6k](/packages/relaticle-custom-fields)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)