spiral/pieces

Spiral Framework Pieces Module

Tuesday, August 8, 2017
by wolfy-j
Repository
4 Watchers
0 Stars
91 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
22 Versions
2 % Grown

The README.md

Pieces Module

This module provide ability to store page pieces data in database (currently ORM only) and access it via Web-API. Also it's compiles two versions of views: one for site editor and one for common site user. The functionality can be sometimes useful especially with something like WriteAway., _(*1)

Installation

$ composer require spiral/pieces
$ ./spiral register spiral/pieces
$ ./spiral up

Add Bootloader

const LOAD = [
    //...
    \Spiral\Pieces\Bootloaders\PiecesBootloaders::class,
]

Configure permissions

Check app/config/modules/pieces.php for details., _(*2)

Metadata

There are two alternatives to include metadata to your pages: "static" and "runtime". First one will fully compile during views compilation and there will be no requests to database during page load. Second one will not., _(*3)

<dark:use path="pieces/meta" as="pieces:meta"/>

<pieces:meta title="Foo" description="Bar" keywords="Baz">
  <meta name="foo" content="bar">
</pieces:meta>

The code above is "static" metadata. You can optionally pass some defaults: title, description, keywords arguments and put custom default html (see code above)., _(*4)

If you need something a bit more complex than dumb static pages, then currently you need to use "runtime" metadata. In opposite to "static" metadata you should pass namespace, view and code arguments, but title, description and keywords are still optional., _(*5)

<dark:use path="pieces/runtime-meta" as="pieces:meta"/>



<pieces:meta title="<?= $entity->title ?>" description="<?= $entity->description ?>"
             namespace="<?= $this->namespace #compile ?>" view="<?= $this->view #compile ?>"
             code="<?= $entity->id ?>">
    <meta name="foo" content="bar">
</pieces:meta>

It's useful to note, that both alternatives will append (in editor mode):, _(*6)

<script>
  window.metadata = <?= json_encode($meta) ?>;
</script>

to help you with frontend editor setup., _(*7)

If you don't like the behaviour you're always free to write your own code... And make a PR. :-), _(*8)

Pieces

Currently there's only "static" pieces., _(*9)

<dark:use path="pieces/piece" as="pieces:piece"/>

<pieces:piece name="sample-piece">
  Piece content.
</pieces:piece>

In editor mode content of the piece will be wrapped in div like this:, _(*10)

<div data-piece="html" data-id="sample-piece">
  Piece content.
</div>

The Versions

08/08 2017

dev-master

9999999-dev

Spiral Framework Pieces Module

library pieces

Spiral Framework Pieces Module

spiral/pieces

The README.md

Pieces Module

Installation

Add Bootloader

Configure permissions

Metadata

Pieces

The Versions

dev-master

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.8

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.7

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

dev-feature/view-cache-targeting-recompile

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.6

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.5

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.3

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v1.0.0

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v0.9.9

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v0.9.8

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v0.9.7

The Requires

The Development Requires

by Dmitry Mironov

by Anton Titov

by Lev Seleznev

v0.9.6

The Requires

The Development Requires