Download the PHP package jaxon-php/jaxon-dialogs without Composer
On this page you can find all versions of the php package jaxon-php/jaxon-dialogs. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jaxon-php/jaxon-dialogs
More information about jaxon-php/jaxon-dialogs
Files in jaxon-php/jaxon-dialogs
Package jaxon-dialogs
Short Description Modal, alerts and confirmation dialogs for Jaxon with various javascript libraries
License BSD-3-Clause
Homepage https://github.com/jaxon-php/jaxon-dialogs
FAQ
Example:
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 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.
Informations about the package jaxon-dialogs
Dialogs for Jaxon
Modals, alerts and confirmation dialogs for Jaxon with various javascript libraries.
Features
This package provides modal, alert and confirmation dialogs to Jaxon applications with various javascript libraries. 12 libraries are currently supported.
The javascript library to use for each function is chosen by configuration, and the package takes care of loading the library files into the page and generating the javascript code.
The URL and version number can be set individually for each javascript library.
Installation
Add the following lines in the composer.json file, and run the composer update command.
Configuration
This package defines 3 config options in the default section to set the default library to be used.
- modal: the default library for modal dialogs
- message: the default library for messages
- question: the default library for questions
The lib.use option allows to load additional libraries into the page, if they are used in the application.
The question section defines options for the question dialog.
The lib.uri option defines the URI where to download the libraries files from.
Specific options can also be set for each library.
Usage
Modal dialogs
This plugin provides functions to show and hide modal dialogs, with a title, a content and zero or more buttons.
The parameters of the show() methods are described as follow:
$title: is a one line text to be printed at the top of the dialog.$content: the HTML content of the dialog.$buttons: a list of buttons to be printed in the dialog. Each button is an array with the following entries:title: the text to be printed in the button.class: the CSS class or classes to be applied on the button.click: the javascript code to be executed on a click on this button. It can be defined using the Request Factory, or it can be set tocloseto close the dialog.
$options: an array of config options that are specific to the javascript library in use.
Example.
Alerts or notifications
This plugin provides functions to show 4 different types of alerts or notification messages.
Example.
Confirmation question
The confirm() function adds a confirmation question to a Jaxon request, which will then be called only if the user answers yes to the given question.
The first parameter, which is mandatory, is the question to ask.
The next parameters are optional; they allow the insertion of content from the web page in the confirmation question, using Jaxon or jQuery selectors and positional placeholders. They are specially useful when pieces of information from the web page need to be inserted in translated strings.
In the example below, the user has to choose a color, and the selected color is inserted in the confirmation question.
Example with Jaxon selector.
Example with jQuery selector.
Supported libraries
This package currently supports 14 javascript libraries, each implementing one or more interfaces.
XDialog
https://xxjapp.github.io/xdialog/
- Dialog id: xdialog
- Implements: Modal, Alert, Confirm
- Version: 3.4.0
CuteAlert
https://github.com/gustavosmanc/cute-alert
- Dialog id: cute
- Implements: Alert, Confirm
- Version:
Bootbox
- Dialog id: bootbox
- Implements: Modal, Alert, Confirm
- Version: 4.3.0
jAlert: https://htmlguyllc.github.io/jAlert/
- Dialog id: jalert
- Implements: Alert, Confirm
- Version: 4.5.1
PgwJS
- Dialog id: pgwjs
- Implements: Modal
- Version: 2.0.0
Toastr
https://codeseven.github.io/toastr/
- Dialog id: toastr
- Implements: Alert
- Version: 2.1.3
Tingle: https://tingle.robinparisi.com/
- Dialog id: tingle
- Implements: Modal
- Version: 0.8.4
Noty: https://ned.im/noty/
- Dialog id: noty
- Implements: Alert, Confirm
- Version: 2.3.11
Notify: https://notifyjs.jpillora.com/
- Dialog id: notify
- Implements: Alert
- Versions: 0.4.2
Overhang: https://paulkr.github.io/overhang.js/ (requires jQuery and jQuery UI)
- Dialog id: overhang
- Implements: Alert, Confirm
- Version:
PNotify: https://sciactive.com/pnotify/ (requires jQuery and jQuery UI)
- Dialog id: pnotify
- Implements: Alert, Confirm
- Version: 3.0.0
Sweet Alert
Sweet Alert: https://sweetalert.js.org/
- Dialog id: sweetalert
- Implements: Alert, Confirm
- Version: 1.1.1
JQuery-Confirm
https://craftpip.github.io/jquery-confirm/
- Dialog id: jconfirm
- Implements: Modal, Alert, Confirm
- Versions: 3.0.1, 3.3.0, 3.3.1, 3.3.2
Bootstrap 3 Dialog: https://nakupanda.github.io/bootstrap3-dialog
- Dialog id: bootstrap
- Implements: Modal, Alert, Confirm
- Versions: 1.35.3
Adding a new library
In order to add a new javascript library to this plugin, a new class needs to be defined and registered.
The class must implement the Jaxon\App\Dialog\LibraryInterface interface, and at least one of the
Jaxon\App\Dialog\LibraryInterface, Jaxon\App\Dialog\LibraryInterface, or Jaxon\App\Dialog\LibraryInterface
interfaces, depending on the features it provides.
Interfaces
The LibraryInterface interface is defined as follow.
It defines the name of the library, and its javascript code.
The getJs() and getCss() methods return the HTML header code for loading javascript and CSS files of the library.
The getScript() method returns the javascript code to be executed after the page is loaded to initialize the library.
Depending on the javascript library features, the class must implement one or more of the following three interfaces.
For windows and modal dialogs.
For notifications dialogs.
For confirmation dialogs.
Helper
The Jaxon\App\Dialog\Library\DialogLibraryTrait provides default implementations for some methods of the
Jaxon\App\Dialog\LibraryInterface interface, as well as a Jaxon\App\Dialog\Library\DialogLibraryHelper object,
returned by the helper() method, which gives access to the dialog config options, and templates.
Registration
After it is defined, the library class needs to be configured and registered before it can be used in the application.
The class can be registered when starting the library.
Or declared in the dialog section of the Jaxon configuration.
Contribute
- Issue Tracker: github.com/jaxon-php/jaxon-dialogs/issues
- Source Code: github.com/jaxon-php/jaxon-dialogs
License
The package is licensed under the BSD license.
