Download the PHP package zareismail/cypress without Composer

Installation

Components

Fragments

Layouts

Widgets

Plugins

Installation

Use the following command to install Cypress:

composer require zareismail/cypress

Components

Defining component

Registering Components

Fallback Component

Customizing Uri

Attach Middleware

Authorization

Resolvable Components

Defining component

By default, Cypress components are stored in the app/Cypress directory of your application. You may generate a new component using the cypress:component Artisan command:

Registering Components

To register your component do it in the boot of a service provider; ike below:

Once your components are registered with Cypress, you can browse to the /blog path to see the result. it will be a blank page. don't worry it will be filled via Layout, later.

Fallback Component

The fallback allows you to define a component that will be executed when no other component matches the incoming request. The return value of the fallback method in component determines that is a fallback or not.

Customizing Uri

The uriKey method of a component enables you to customize its request path. The uriKey of a component using to prefix its corresponding laravel route. The uriKey key of a fallback component will be ignored on the route prefixing.

Attach Middleware

With the middlewares method of a component, you can attach some middlewares into the component corresponding routes.

Authorization

The canSee method of the component allows you to authorize certain requests. You can use this on the resolveable components

Resolving Component

Each component that implements the Zareismail\Cypress\Contracts\Resolvable interface; allows you to do more on a component like authorization and passing data. The resolve method of a component allows you access to the component instance after its creation, so any component configuration should be inserted into this method. The return value of the resolve method determines the Cypress should respond with 404 or not which means the component is accessible or not.

Fragments

Defining fragments

Registering Fragments

Fallback Fragment

Customizing Uri

Authorization

Resolvable Fragment

Defining Fragments

Cypress component works like a router group with default route /. to deep in routing you should use fragments. the following command create new fragment in the app/Cypress/Fragments directory.

Registering Fragments

When a fragment defined, you need to attach it to a component. Each component generated by Cypress contains a fragments method. To attach a fragment to a component, you should simply add it to the array of fragments returned by this method:

After fragment registration, navigate to the blog/posts. you can see a new blank page. dont worry; this page also will be filled with the Layout

Fallback Fragment

Like fallback components ; The fallback allows you to define a fragment that will be executed when no other fragment matches the incoming request. The return value of the fallback method in component determines that is a fallback or not.

Attention

Each Cypress can have only one fallback component but have a fallback fragment on each component.

Customizing Uri

The uriKey method of a fragment enables you to customize its request path. But in this case; all the paths that started with the uriKey of the component + fragment will pass into it.

Authorization

The canSee method of the fragment allows you to authorize certain requests. You can use this on the resolveable fragments

Resolving Fragment

Each fragment that implements the Zareismail\Cypress\Contracts\Resolvable interface; allows you to do more on a fragment like authorization and passing data. The resolve method of a fragment allows you access to the fragment instance after its creation, so any fragment configuration should be inserted into this method. The return value of the resolve method determines the Cypress should respond with 404 or not which means the fragment is accessible or not.

Layouts

Defining Layouts

Registering Layouts

Layout View

Defining Layouts

Cypress layout is a way to fill the page for the fragments. following command create a new layout in app/Cypress/Layouts directory of your application.

Registering Layouts

Each Cypress layout should be attached into a component. For this, you should override the $layout property of the component.

And now if you refresh the browser again, you see the blank page. To fill the layout with data you should following the widgets documents.

Layout View

Each layout generated by Cypress has a corresponding laravel view in the resources/views directory of your application. The viewName method of a layout accepts the name of your Laravel view that you want to render for it.

Widgets

Defining Widgets

Registering Widgets

Booting

Showing / Hiding Widgets

Widget Rendering

Widget Authorization

Defining Widgets

The Cypress widgets are the way to interacts with the views. The following command create a new widget in app/Cypress/Widgets directory of your application.

Registering Widgets

Once you have defined a widget, you are ready to attach it to a layout. Each layout generated by Cypress contains a widgets method. To attach a widget to a layout, you should simply add it to the array of widgets returned by this method. Each widget requires a specific name to registering. This is uriKey of the widget.

And now if you refresh the browser again, you see the content generated by the widget.

Booting

The boot method of a widgets allows you to pass data to the widget or intracts with Cypress layouts, components and fragments. This method call after component and fragment resolved. This means that you have access to the data generated by components and framengments easily.

Showing / Hiding Widgets

Often, you will only want to display a widget in certain situations. For example, you want only display slider on the site index. The following methods may be used to show / hide widgets based on the component requests or fragment requests:

• hideFromComponent
• showOnComponent
• onlyOnComponent
• hideFromFragment
• showOnFragment
• onlyOnFragment

You may pass a callback to this methods.

Widget Rendering

The render method of widget helps you to display content of the widget. you are free to return view or any Htmlable, Renderable or string from this method.

Widget Authorization

The canSee method of the widget allows you to authorize certain requests. you may chain the canSee method onto your widget registration:

Plugins

Defining Plugins

Registering Plugins

Rendering Asset

Defining Plugins

When you creating a tempalte for a site, you need to insert css, js and another meta tag into head or body. Cypress plugins allows you to do this. The following artisan command create a new plugin in the app/Cypress/Plugins directory of your application.

Registering Plugins

Once you have defined a plugin, you are ready to attach it to a layout. Each layout generated by Cypress contains a plugins method. To attach a plugin to a layout, you should simply add it to the array of plugins returned by this method.

Rendering Asset

The render method of plugin allows you to insert some tag into the head or body of the corresponding html of the layout. For example to load the bootstrap assets in the template insert the following code into the created plugin.

The asMetaData method of plugin allows you to determine where the plugin should be render. Returning true value from this method allows you render the plugin in the head of html.