Download the PHP package vortechron/filament-block-editor without Composer

On this page you can find all versions of the php package vortechron/filament-block-editor. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package filament-block-editor

Block Editor

A visual page builder, like a small Elementor, that works in any web app and plugs into Filament 5.

The client builds pages from sections. They pick ready-made sections, type straight into the page, drag things around, and see the real page in a live frame on desktop or phone width. Every change can be undone and redone (the top bar's buttons, or Ctrl+Z / ⌘Z) until the page is reloaded. You keep control of the design: your own CSS themes the page, and your own blocks draw the parts of the design that must not break.

It started as the page builder of NakJual and is made generic here.

Requirements

Install

Show a page

A page is a page value stored as JSON: ['version' => 2, 'sections' => [...]] (see The page value). Older values (a bare list, or ['sections' => [...]]) are upgraded when they are read. Draw it with:

The styles component also prints the site's design kit (colours, fonts, corners, buttons, forms). You can still theme with CSS custom properties (--sf-accent, --sf-text, --sf-heading-font, ...): see docs/php.md.

Edit a page in Filament

Use the trait on any Filament page, standalone or inside a resource:

Every save by someone who is not a developer keeps the stored locks and developer-only data (PageValue::guard()). Override these hooks to switch more on; each one has a safe default, and the builder only offers what you override:

The builder always gets the current kit (kit) and Kit::defaults() (kitDefaults, with your config), for its colour and font pickers; the design panel shows only when you override savePageBuilderKit().

With shop info (getPageBuilderSiteInfo() and savePageBuilderSiteInfo()), the top bar gets a "Shop info" button, and every item that shows shop info lists those values as short rows ("From shop info") with what they are now; a tap opens that group of the form. The values come from an own block's showsValues('site.phone'), the chips, short codes and @key links it uses, each through its settings group (register(..., settings: 'contact')); an own block's usesSiteInfo('contact') adds a whole group. The canvas follows the form before it is saved: draw your preview with the unsaved values in withPageBuilderSiteInfo(), and never save them there. More in docs/php.md.

Register the route like any resource page ('build' => BuildPage::route('/{record}/build')) and add FilamentBlockEditorPlugin::make() to the panel. Uploads go to config('filament-block-editor.disk') (public by default; any public disk, such as S3 or MinIO, works). For a page that is not a resource page, extend Vortechron\FilamentBlockEditor\Filament\Pages\PageBuilderPage.

Your own blocks

Draw the parts of a design the client fills in but cannot break. Declare the fields in PHP; the builder gets a generated form, and your Blade view draws the block:

Field types: text, textarea, select, toggle, number, image, link, list. Values are cleaned by the definition before your view sees them. A block that shows shop info names the values with ->showsValues('site.phone', 'site.address') (or whole groups with ->usesSiteInfo('hours')), so its panel lists them. A text or textarea value may hold short codes like Hubungi {site.phone}; your view gets them filled in. Mark a field ->developerOnly() to keep it to developers. A section with width: full and padding: none lets your block draw edge to edge. More in docs/php.md.

A block that shows data kept somewhere else, like a list of items, names that screen with ->editedAt('Edit items', fn () => ItemResource::getUrl()): its settings then show its description and a button there, never an empty tab. A select can read its choices when they are needed, such as from the database: Field::select('category')->options(fn () => Category::pluck('name', 'id')->all()) (keys by id are kept). A select of icons becomes a drop-down with each icon's picture beside its name with ->icons(fn (string $value) => '<svg ...>'); the builder keeps only plain shapes from it. The Icon list block does this with the package's own icons (Support\Icons::choices() and svg()).

For a long list, cut it into pages a visitor flips through with ‹ ›, with no JavaScript:

The title lists the other pages to build when the host returns them from getPageBuilderPageMenu() (['title' => ..., 'url' => <its builder>, 'current' => bool]); a tap opens one, asking first about unsaved changes. Beside the screen sizes, "Edit without the page" gives the editor panel the whole width; otherwise its edge drags to any width (kept in the browser; Home or a double-tap resets it).

In the builder, every item has a Replace button: the owner picks another item, like Image where a drawing was, and it goes in the same place, in one undo step.

Use the builder anywhere else

The builder needs only an element and an adapter. Any backend works, as long as it can draw the page for the preview (the PHP layer does that for Laravel; another stack draws the same HTML from the same JSON):

The full option list and the adapter types are in docs/v1-architecture.md and builder/src/index.ts.

Languages

The builder speaks the app's language: Bahasa Melayu when app()->getLocale() starts with ms, English otherwise. The page speaks the site's: set SITE_LOCALE (content_locale in the config) when the two differ, for example APP_LOCALE=en and SITE_LOCALE=ms for an English panel and a Malay site. PageRenderer then draws every page in the site's language (Rendering\ContentLocale::run()), so a form's button and messages and the map link are Malay in the live page and in the builder's preview, while the builder's own notes stay English. Ready-made sections keep English names and get Malay words. A new form or button starts in the site's language too (the contentLocale option): the labels, button and thank-you message visitors read are Malay, while the form's name and the email subject, which only the owner sees, stay English. Unset, both are the app's language.

For a multilingual host, override getPageBuilderContentLocale(): string with the locale of the record being edited. Options, default values, saves and previews run inside ContentLocale::with($locale, $draw). It changes ContentLocale::site() for that callback, supports nesting and restores it after exceptions. It leaves the panel's app locale unchanged; nested ContentLocale::run() draws in the override and panel() still reads the panel language. Use with() around public page rendering too when the host selects a translated page.

Add the top-bar language menu with these hooks on the page using InteractsWithPageBuilder:

The default language list is empty; fewer than two valid entries hides the menu. An existing URL opens that record's separate editor. A null URL offers "Create English draft" through the Livewire action above, whose default refuses with 403. A standalone JS host supplies the same languages option and adapter.createTranslation(locale): Promise<{ url: string }>. Without that callback, creation is disabled. The host owns record creation, locale validation, permission checks and the returned URL. No content is sent to the creation callback, no text is automatically translated, and language selection never saves the open record. The builder asks before discarding unsaved page content, design or shop info. Full-page navigation starts a fresh editor so undo cannot cross languages. The host's pages, parts and page menu should return links for the selected content locale too.

Custom block defaults may use callbacks, evaluated when defaults are needed, including inside lists:

Keep panel labels in the panel language. Core block sample text and new forms use the selected content locale; stored text is kept as written.

Every new item starts with words in the site's language, so it never lands blank on the page: a heading says "Tajuk anda", a text "Tulis ayat anda di sini.", a question has an answer, each new column a line. The item panel changes a text item's words in a plain box (bold, colours, links and shop info chips stay in the section's editor), and a slideshow's photos are added, moved and removed on its Settings tab.

Ready-made blocks

The package registers five blocks for every site: FAQ (fbe-faq), map (fbe-map), icon list (fbe-icon-list), pricing (fbe-pricing) and testimonials (fbe-testimonials). Anyone can also build a form in the editor (the form block); your app saves the submissions through a FormEndpoint. Turn the ready-made blocks off with 'core_blocks' => false. More in docs/php.md.

What changed in 2.0

2.0 is page format 2 (the full plan is docs/v2-plan.md). Old pages need no data move: a page value without a version is upgraded when it is read.

What changed from 0.1

1.0 is a rewrite. The 0.1 form field (BlockSections), the ContentBlock, BlockStyle, SavedBlock and media library models and screens, and block presets are gone. No project used 0.1.

Package development

The builder's limits come from PHP (Support\BuilderRules), and tests/fixtures/shared holds cases both test suites run, so the two sides clean every value the same way. See docs/php.md.

builder/demo/index.html mounts the built bundle with an in-memory adapter for a quick look in a browser. The workbench has a sample page at / (composer serve) and a demo builder at /admin/demo-builder.

License

GPL-3.0-or-later, as before (see LICENSE).

Shared pages with text per field

A host may keep one format-2 page and add optional translations[locale] text maps. Structure, block styles, pictures, form keys and action targets remain shared. Inline words, marks and links may differ by language. Enable field controls with:

The equivalent JS option is fieldLanguages. Each text field selects its own language without saving or navigating. The separate Preview language selects the full page's language. A missing translation shows the base words and a missing-language hint. An explicit empty string stays empty. Save and undo include every language draft. Edits made during a pending save remain unsaved.

Field::text() and Field::textarea() translate by default. Use ->translatable(false) for facts, prices, identifiers and code. Field::isTranslatable() and toArray()['translatable'] expose the rule. Other field types never translate. Registered list fields translate their declared text children. List rows reserve _id; form choices reserve option_ids. Keep these identities when moving rows. Existing form block ids, field ids and submission names stay unchanged.

Use Content\TextTranslations::ensureIds($base) once and persist its result when converting a shared page. extract($base, $translated) returns the opaque text map, including equal and empty words; it throws InvalidArgumentException for shared layout changes or unknown custom/form data. Missing ids in a legacy translation align with the base. Rich inline words, marks and safe inline links are independent per language. A cleared base field does not erase another language. normalizeOverrides($base, $map) drops unknown plain keys and values for available definitions. Invalid rich values are refused. apply($base, $map) returns the selected format-2 page without its language maps. All four methods accept a page value or section list. Callers should not construct text keys. Rich fields use one durable key, block:<id>/rich, whose value is a versioned JSON string: {"version":1,"content":[...BlockNote inline items...]}. An explicit empty inline tree {"version":1,"content":[]} is a saved value; no override means fallback. The field stays stable when BlockNote splits or merges styled text. Unknown inline shapes, unsafe links, privileged chip properties, unknown chip keys and payloads above 100000 bytes are refused. Rich JSON is never truncated. A chip may use an existing base key or a registered shared key and carries only that key. Earlier unreleased /content/... run maps are refused with a rebuild message.

An identified table cell uses block:<tableId>/rich-cell:<cellId> and a cell _id. Table layout is shared. Missing or orphaned translated cell ids refuse the save. The section editor preserves ids for unchanged tables and rolls back table edits whose identity it cannot safely track, with an owner message. It never guesses which moved cell owns a translation. In a host with field languages, select a Table item to edit each named row/column Words field, or use “Edit table N words” in the section editor. Each cell has its own language footer and complete inline editor. A new Table gets fresh cell ids before its first draft; an explicit Duplicate keeps the source cell identities under the new table block id. Native table editing remains available without a field-languages envelope.

Words now has one language footer for the complete field. Plain paragraphs and quotes retain their four-row text boxes. "Format words" opens the inline editor for the selected language; marked text opens it directly. The section editor edits the default language; individual Words fields edit their selected languages. Save, reload, undo and redo retain the complete language values. The link controls preserve relative page paths, query strings and anchors. Unsafe or malformed web links are refused before changing the draft, and the public PHP save validates them again. PageRenderer resolves the map using ContentLocale::site() at the public rendering boundary.

PageValue::normalize() preserves and cleans optional language maps. Its guard also protects locked and developer-only words. Unilingual values keep the previous normalization behavior; merely reading a legacy page does not add new block identities. The old getPageBuilderLanguages() navigation and creation hooks continue working for hosts with separate language documents.

If a custom block definition is temporarily missing, ordinary normalization keeps its data and opaque maps scoped to its block ids. PageValue::guard() freezes those blocks and maps to their stored values while allowing unrelated fields to change. TextTranslations::textFields() reads only currently understood fields for permission checks; extract() remains strict for conversion. A client cannot add or reuse a missing block without a stored baseline. Such a section save returns a failed-save message asking the owner to re-enable the definition, preserving the source drafts.

Ordinary translated-document edits use extractForEdit($base, $translated, $storedOverrides). It refuses shared layout/media/action changes, freezes missing definitions, and retains absent fallback keys for untouched fields. restoreOverrides($base, $desiredOverrides, $storedOverrides) restores exact understood key presence while keeping unavailable fields at their current stored values. Conversion continues to use strict extract().

Field::text(...)->emptyFallback() (also textarea) declares that legacy empty words mean a dynamic host fallback. Extraction records this mode as <field-key>/_empty_fallback = '1' only alongside an empty override for a declared field. Form submit/success slots support the same legacy mode. A new field edit removes only its companion; an explicit empty override then stays blank. A host view may call TextTranslations::isExplicitlyBlank($block, 'title') to distinguish it from automatic text. The generated block _translated_empty list validates declared fields and stable repeater paths, survives rendering normalization, and follows the same locked/developer guards as its words. Hosts keep their own fallback calculation; the package never stores the calculated category name.

Saving a copy or making a section synced sends only that section's maps in optional adapter.saveSection(section, {title, synced, translations}). Hosts may override savePageBuilderSectionTranslations($section, $title, $synced, $translations); its default delegates to the unchanged older hook. The public saveSectionFromPageBuilder accepts maps as its fourth argument and validates and guards the complete value before calling the hook. A successful result may return canonical section and translations; template and synced-library entries carry maps beside section. Copies and detached sections remap words to the actual copied block ids in one undo step. A pending response never replaces a source whose words or maps changed after capture.

Previews accept previewPageBuilder($value, $kit, $siteInfo, $contentLocale, $siteInfoTranslations); only enabled field languages can override the preview locale. Malformed rich values return a failed save with a useful panel-language message, without saving partial data. The adapter supplies these as PreviewExtra.contentLocale and PreviewExtra.siteInfoTranslations.

Shop info may return translations[locale][group][field] beside groups and base values. Only explicitly translatable top-level settings text gets a language control; nested settings lists stay shared. Declare phone numbers, addresses, hours and other facts translatable(false). adapter.saveSiteInfo(values, translations?) saves all drafts. Hosts supporting translated settings override the additive hooks savePageBuilderSiteInfoTranslations(array $values, array $translations) and withPageBuilderSiteInfoTranslations(array $values, array $translations, Closure $draw). Their defaults delegate to the old one-language hooks, whose signatures are unchanged.

Deliberately cleared default or translated form submit/success text carries the narrow _translated_empty form metadata so legacy defaults do not replace an intentional blank. The real field control records default-language clears; both cleaners retain only supported, actually blank slots. It is not an arbitrary form-data extension; conversion still rejects unknown form data.


All versions of filament-block-editor with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
filament/filament Version ^5.7
spatie/laravel-package-tools Version ^1.16
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package vortechron/filament-block-editor contains the following files

Loading the files please wait ...