Download the PHP package lexxyungcarter/ziggy without Composer

On this page you can find all versions of the php package lexxyungcarter/ziggy. 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 ziggy

Ziggy - Use your Laravel Named Routes inside JavaScript

Ziggy - Use your Laravel Named Routes inside JavaScript

TravisCi Status for tightenco/ziggy Total Downloads Latest Stable Version License

Ziggy creates a Blade directive which you can include in your views. This will export a JavaScript object of your application's named routes, keyed by their names (aliases), as well as a global route() helper function which you can use to access your routes in your JavaScript.

Installation

  1. Add Ziggy to your Composer file: composer require lexxyungcarter/ziggy

  2. (if Laravel 5.4) Add Lexx\Ziggy\ZiggyServiceProvider::class to the providers array in your config/app.php.

  3. Include our Blade Directive (@routes) somewhere in your template before your main application JavaScript is loaded—likely in the header somewhere.

Usage

This package replaces the @routes directive with a collection of all of your application's routes, keyed by their names. This collection is available at Ziggy.namedRoutes.

The package also creates an optional route() JavaScript helper which functions like Laravel's route() PHP helper, which can be used to retrieve URLs by name and (optionally) parameters.

Examples:

Without parameters:

With required parameter:

With multiple required parameters:

With query parameters:

If whole objects are passed, Ziggy will automatically look for id primary key:

Practical AJAX example:

Default Values

See Laravel documentation

Default values work out of the box for Laravel versions >= 5.5.29, for the previous versions you will need to set the default parameters by including this code somewhere in the same page as our Blade Directive (@routes)

Filtering Routes

Filtering routes is completely optional. If you want to pass all of your routes to JavaScript by default, you can carry on using Ziggy as described above.

Basic Whitelisting & Blacklisting

To take advantage of basic whitelisting or blacklisting of routes, you will first need to create a standard config file called ziggy.php in the config/ directory of your Laravel app and set either the whitelist or blacklist setting to an array of route names.

Note: You've got to choose one or the other. Setting whitelist and blacklist will disable filtering altogether and simply return the default list of routes.

Example config/ziggy.php:

As shown in the example above, Ziggy the use of asterisks as wildcards in filters. home will only match the route named home whereas api.* will match any route whose name begins with api., such as api.posts.index and api.users.show.

Simple Whitelisting & Blacklisting Macros

Whitelisting and blacklisting can also be achieved using the following macros.

Example Whitelisting

Example Blacklisting

Advanced Whitelisting Using Groups

You may also optionally define multiple whitelists by defining groups in your config/ziggy.php:

In the above example, you can see we have configured multiple whitelists for different user roles. You may expose a specific whitelist group by passing the group key into @routes within your blade view. Example:

Note: Using a group will always take precedence over the above mentioned whitelist and blacklist settings.

Other useful methods

current()

To get the name of the current route (based on the browser's window.location) you can use:

To check that we are at a current route, pass the desired route in the only param:

You can even use wildcards:

url()

Ziggy returns a wrapper of the string primitive, which behaves exactly like a string in almost all cases. In rare cases where third-party libraries use strict type checking, you may require an actual String literal.

To achieve this simple call .url() on your route:

Artisan command

Ziggy publishes an artisan command to generate a ziggy.js routes file, which can be used as part of an asset pipeline such as Laravel Mix.

You can run php artisan ziggy:generate in your project to generate a static routes file in resources/assets/js/ziggy.js.

Optionally, include a second parameter to override the path and file names (you must pass a file name with the path):

Example ziggy.js, where the named routes home and login exist in routes/web.php:

Importing the route() helper and generated ziggy.js

Using with Vue

components

If you want to use the route() helper within a Vue component, import the helper and generated ziggy.js as above. Then you'll need to add this to your app.js file:

Then, use the method in your Vue components like so:

<a class="nav-link" :href="route('home')">Home</a>

Thanks to Archer70 for this solution.

Using with Vue-Router

Since vue router accepts only relative urls, a relative() method exists that returns a relative url from the normal absolute url got from route() method. So you can simply chain it.

NB As a precaution, colons get encoded to %3A when urls are generated with route(), so it would be a good idea to pass true to the relative method. Behind the scenes, the decodeURIComponent gets called and ensures that the collon is returned.

Using with laravel-haml (and other custom Blade compilers)

Environment-based loading of minified route helper file

When loading the blade helper file, Ziggy will detect the current environment and minify the output if APP_ENV is not local.

When this happens, ziggy.min.js will be loaded. Otherwise, ziggy.js will be used.

Optional route helper

If you only want routes available through @routes, but don't need the route helper function, you can include skip-route-function in your config and set it to true:

Contributions & Credits

To get started contributing to Ziggy, check out the contribution guide.

Thanks to Caleb Porzio, Adam Wathan, and Jeffrey Way for help solidifying the idea.

Thanks to all our contributors


All versions of ziggy with dependencies

PHP Build Version
Package Version
Requires laravel/framework Version >=5.4@dev
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 lexxyungcarter/ziggy contains the following files

Loading the files please wait ....