PHP download

Download the PHP package wisam-alhennawi/lara-forms-builder without Composer

On this page you can find all versions of the php package wisam-alhennawi/lara-forms-builder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download wisam-alhennawi/lara-forms-builder
More information about wisam-alhennawi/lara-forms-builder
Files in wisam-alhennawi/lara-forms-builder

Vendor wisam-alhennawi
Package lara-forms-builder
Short Description This is my package lara-forms-builder
License MIT
Homepage https://github.com/wisam-alhennawi/lara-forms-builder

Keywords laravel wisam-alhennawi lara-forms-builder

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?

Example code of wisam-alhennawi/lara-forms-builder

Informations about the package lara-forms-builder

lara-forms-builder package

About

The main functionality of this package is:

Generate Livewire forms (Show, Create, Update) by using one command and one Livewire component.

Requirements

The following dependencies are required to use the package:

Dependency	Version
PHP	8.x
Laravel	10.x
Jetstream	4.x	💡
Livewire	3.x	💡
Alpine.js	3.x	💡
TailwindCSS	3.x	💡
Pikaday	1.x	💡
Moment	2.x	💡

💡 => You can install it with Auto Setup & Configuration.

Note that (pikaday & moment) npm packages is required only if you have a date field within your form.

Installation

Upgrade Guide

If you want to use the package in an existing project that use v1 the following changed are required.

all placed uses $this->property should be replaced with $this->formProperties['property']

Auto Setup & Configuration

This command will do the following:

Install "laravel/jetstream": "^4.0" with "livewire/livewire": "^3.0" if not installed. Installing jetstream will install "tailwindcss": "^3.0" & "alpinejs": "^3.0".
Install "pikaday": "^1.0" and "moment": "^2.0" npm packages and make required configuration.
Add confirmation modal component to app.blade.php layout.
publish lara-forms-builder.php config file and make required configuration.
publish lara-forms-builder.css assets file and make required configuration.
Run npm install & npm run build.

Configuration

Publishing Assets

1) #### Config (Mandatory) You Must publish the config file and add it to the tailwind.config.js in order to apply the styles:

This is the contents of the published config file:

Update tailwind.config.js:

2) #### CSS (Mandatory) Publishing css file is Mandatory to apply styles.

That will make a new css file lara-forms-builder.css in the public/vendor/lara-forms-builder/css/ directory. After that you must import this file with your resources/css/app.css by adding:

And feel free to edit the default style in lara-forms-builder.css to fulfil your form requirements style.

3) #### Translation (optional)

4) #### Views (optional)

Using date in form (optional)

Like it mention in the Requirements section if your form has a date field you must install required dependencies by following these steps:

Installing pikaday:

add these to your resources/js/app.js

add these to your resources/css/app.css
Installing moment:

Use confirmation modal

In order to use the confirmation modal within your project you must include it globally in the default layout of your blade view where you want to use it. So you can add @livewire('modals.confirmation') to your views/layouts/app.blade.php inside the html <body> tag.

Usage

Create new Livewire from

By using this command you can create a new Livewire form depending on a model, additionally you can add [--langModelFileName=] tag to specify a lang file for model fields labels:

Examples:

Form Component Types and Attributes

Forms are specified in a declarative manner as an array of the fields function in the form component class.

beforeFormProperties(), afterFormProperties() functions used to set options, values, etc. before/after setting the form properties (e.g. developers options in the following example).

saveDevelopers() function used to make operation after create/update a model (e.g. developers ids & project id will be saved in pivot table in the following example).

Note: saveDevelopers()functions should follow the naming convention of the form field name developers.

The definition above is then rendered as displayed in this screenshot (with additional language dependent translations for the labels required):

All form components have the following general properties:

type (mandatory): Specifies the kind of form component, see the following subsections for supported types and their individual properties
label (mandatory): Label text of the component, can also include HTML tags (please handle responsibly and do not allow user input to be used as labels)
validationAttribute (optional): If set, the value will be used as the attribute label for validation messages. If not set, the label is also used as a field name for validation messages.
helpText (optional): Help text displayed at the bottom of the component
readOnly (optional): When set to true, the form field does not allow input or changes and only displays the current value
rules (optional): Validation rules to be applied for this field. If not set, Eloquent model rules for the field with the same name will be used if available, otherwise no rules are applied.
field_wrapper_class (optional): CSS class(es) to be added to the div that encloses the form component
tooltip (optional): if set, the value is displayed as text in a tooltip on hover over a question mark icon rendered next to the label text

Type `input`

The input form field is a classic html input element. It has the following additional properties:

inputType (optional): Specifies the specific type of input, e.g. email, number, url. Default if not provided is text.
secretValueToggle (optional): Flag relevant for input type password, if set to true, an icon is displayed at the right end of the input field that allows to toggle the visilibity of the masked value on click.

Type `textarea`

The textarea form field represents a text area and has the following additional properties:

rows (optional): Defines the number of rows of the text area, default if not set is 5.

Type `select`

The select form field is a select box for single selection. It has the following additional properties:

options (mandatory): Specifies the options to be displayed in the select box, provided as an array of objects with attributes value and label or a nested array of group label to array of objects with attributes value and label when grouped.
isGrouped (optional): Defines whether the options are grouped, default when not set is false.
styled (optional, not combinable with isGrouped): When set to true, uses a stylable div based select component instead of the html select element.
searchable (optional, only when styled is true): When set to true, adds a search field that allows to filter the options for search expressions (simple case insensitive substring matching)

Type `radio`

The radio form field represents radio buttons and has the following additional properties:

options (mandatory): Specifies the options for the radio button selection as a simple array value => label.

Type `cards`

The cards form field is a special layout element used to select among different options by clicking on one of several cards with rich content and an icon. It has the following additional properties:

options (mandatory): Specifies the options to be selected as an array of objects with attributes value and label (can be HTML).
icon (optional): SVG markup or URL to be displayed as icon in all cards, if not set, no icon is displayed.
card_field_error_wrapper_class (optional): CSS class(es) to be added to error message boxes.
errorMessageIcon (optional): Customized icon markup to be displayed in an error message, if not set, a default icon is used.

Type `checkbox`

The checkbox form field is a single checkbox and does not have any additional properties.

Type `checkbox-group`

The checkbox-group form field is a multi-select group of checkboxes. It has the following additional properties:

options (mandatory): Specifies the values and labels for the checkboxes, provided as an array of objects with attributes value and label or a nested array of category label to array of objects with attributes value and label when grouped by category.
hasCategory (optional): Defines whether the checkbox entries are grouped by category, default if not set is false.

Type `date-picker`

The date-picker form field adds a Pikaday date picker. It does not have any additional properties.

Type `file`

The file form field represents a file input for a single file upload. It has the following additional properties:

preview (optional): If set to the value image, a preview of the uploaded or existing file is displayed. In order to properly show a preview of an existing file (when editing an existing model), the URL to download the existing file must be set as an additional property $this.{$key . '_preview'}, e.g. contact_photo_preview for a field key contact_property. The preview URL can be determined and set in the afterFormProperties function.
removeIcon (optional): Customized icon markup to be displayed as the icon to remove/reset a selected file before saving. If not set, a default icon is used.

Since binary files are usually not directly stored as properties of an Eloquent model, but must be processed separately, this type of form field will in most cases need additional file handling logic in the implementing form. The implementation follows the principles of Livewire file uploads (https://laravel-livewire.com/docs/2.x/file-uploads) and essentially provides the view part of file upload. It is suggested to add the file handling in one of the callback or override functions, e.g. the save... function of the property such as the following code snippet for a property attachment:

Type `search-picker`

The search-picker form field is an input field with search functionality which display the results as a list under the field. It has the following additional properties:

placeholder (optional): Specifies the placeholder of the input field.
searchPickerResultsProperty (mandatory): Refers to the defined array which has the search results. Every element in the array should have the following structure:

Note: getUserIdOptions(), getUserIdSearchPickerSelectedValueProperty() functions should follow the naming convention of the form field name user_id.

Type `trix-editor`

The trix-editor form field is a rich text editor which uses Trix under the hood. It has the general properties mentioned above excluding readOnly.

In order to use the trix-editor form field you have to add the following to your blade:

Please see the full documentation on the official Trix page .

Form Layout

Tabs

A custom layout for components that utilize tabs to organize content.
Each tab is represented as an array (in fields() method) containing 'key', 'title', and 'content'. The key represents an internal technical key uniquely identifying the tab. The title property is used as label for both the tab navigation and the heading of the form; if an alternative (usually shortened) title for the navigation should be used, this can be specified with the optional property navTitle. The 'content' array includes information about the form fields, their types, labels, options, and styling.

Multi-Step

The Multi-Step feature is designed to facilitate the creation of multi-step forms with a Tabs Layout. It provides methods to initialize steps, set the active step number, navigate between steps, and retrieve information about the form's multi-step structure.
Usage
- It works for now only with Tabs Layout and it is deactivated by default.
- To enable the multi-step functionality, set the isMultiStep property to true when configuring the form.
Example:

Form Methods

protected function successMessage()
- Purpose:
  - The successMessage() function is responsible for generating a success message based on the outcome of a form submission.
- Custom Success Message:
  - If a custom success message is provided through the $customSuccessMessage property, it will be used.
- Default Success Messages:
  - If no custom success message is set, default success messages are used for create and update modes.
  - These default messages can be further customized by adding translation keys in the language file.
    
    Example:
- Displaying the Success Message:
  - The success message is displayed to the user either as a flash message or through a browser event. The display method depends on the value of the $hasSession property, which is true by default.
- Another way to customize the success message is to override the successMessage() method in the component class.
protected function canSubmit(): bool
- Purpose: Check if the user is authorized to submit the form
protected function fieldIndicator($fieldKey): ?string
- Purpose:
  - Display an indicator (*) for a required field in the form based on required rule in the rules array
- Customization:
  - An indicator can be displayed based on a custom check (eg. conditional required rules like required_if), to do that shouldDisplayIndicatorBasedOnCustomCheck($key) should be overwritten: Example:

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

Wisam Alhennawi
All Contributors

License

The MIT License (MIT). Please see License File for more information.

All versions of lara-forms-builder with dependencies

PHP Build Version

Package Version

Version v2.0.0 Release 09. Oct 2024
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of lara-forms-builder from vendor wisam-alhennawi

Requires php Version ^8.1
illuminate/support Version ^10.0|^9.0
livewire/livewire Version ^3.0
spatie/laravel-package-tools Version ^1.13.0

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 wisam-alhennawi/lara-forms-builder contains the following files

Loading the files please wait ....