Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hws47a/VF_EasyAjax

[Magento 1 Extension] It allows frontend developer to send ajax requests and return a custom information from the server without a php developer help (without any php code).
https://github.com/hws47a/VF_EasyAjax

magento php

Last synced: 6 days ago
JSON representation

[Magento 1 Extension] It allows frontend developer to send ajax requests and return a custom information from the server without a php developer help (without any php code).

Host: GitHub
URL: https://github.com/hws47a/VF_EasyAjax
Owner: hws47a
Created: 2012-01-02T19:53:13.000Z (almost 13 years ago)
Default Branch: master
Last Pushed: 2018-03-13T20:12:53.000Z (over 6 years ago)
Last Synced: 2024-08-02T08:09:38.878Z (3 months ago)
Topics: magento, php
Language: PHP
Homepage: https://fishchenko.com/projects/easy-ajax
Size: 60.5 KB
Stars: 63
Watchers: 11
Forks: 14
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome-magento - VF EasyAjax - Send ajax requests and return a custom information from the server. (Modules)

README

# VF_EasyAjax Module

[![Build Status](https://travis-ci.org/hws47a/VF_EasyAjax.svg?branch=master)](https://travis-ci.org/hws47a/VF_EasyAjax)
[![Codacy Badge](https://api.codacy.com/project/badge/grade/293388b1fa664d6ab6f1bed025a963e0)](https://www.codacy.com/app/hws47a/VF_EasyAjax)

Allows frontend developers send ajax requests for every page and get Json response.
You don't need to work with app/code section of Manento and change any PHP code.
Make all what you need works via Ajax using only layout xmls, theme templates and javascript.

In the Json response frontend developers can receive:
* All messages that were added to session
* Some blocks from current page layout
* Any block that should be added to special layout xml

See the example of using Easy Ajax extension: [Ajax Cart extension with only one JS file and without any PHP code](https://github.com/hws47a/VF_AjaxCart).

## What's new?

* Added 'update' method to easy load and update container with data using mapping
* Fixed compartability with prototype 1.6 (Magento < 1.6)
* Fixed checking that module is enabled
* Fixed compartability with Magento < 1.6
* Added 'redirect' param with url where controller want to redirect
* Fixed issue with custom layout when cache is enabled

## How to install

You can either copy all files to magento root and install it using modman or composer

To install using composer make sure that you have firegento repository set
```
"repositories": {
"firegento": {
"type": "composer",
"url": "https://packages.firegento.com"
}
}
```

then add `"hws47a/easy_ajax":"~1.1"` package to the require part.

## How to use:

For any page url add easy_ajax=1 and this page returns json instead of html.
It returns:
1. messages: [{type: , code: }] if on this page some message is added to any session model.
2. action_content_data: {} if you add to params action_content[] with block names
3. custom_content_data: {} if you add to params custom_content[] with block names

### Custom layout:
You can use additional layout handlers for easy ajax requests:
* \ - blocks from it can be loaded from any easy ajax request
* \ - you can specify a layout for each action. blocks from it can be loaded only from ROUTE_CONTROLLER_ACTION request.

### Example

For add product to cart via Ajax use default add to cart url and add this params:
* easy_ajax: 1
* action_content[0]:cart_sidebar
* action_content[1]:top.links

You will get json response with
* messages: [{type: 'success', code: 'Massage that product was successfully added to cart.'}]
* action_content_data: {cart_sidebar: "\

", top.links: "\

### Custom layout example

Add to layout handler \ some block with name "test_default"
Add to layout handler \ some block with name "test"
Add to request 2 additional fields:
* custom_content[0]: test_default
* custom_content[1]: test

You will get response with additional field:
* custom_content_data: {test_default: "...", test: "..."}

### JS Wrapper for requests

1\. Using `EasyAjax.Request` instead of `Ajax.Request` you don't need to specify easy_ajax=1 param and you can add action_content and custom_content params easy.
To add action_content and/or custom_content params just add it to options list as arrays.

Example:
```
new EasyAjax.Request(href, {
method: 'post',
action_content: ['cart_sidebar', 'top.links'],
parameters: params,
onComplete: function (transport) {
//some code...
}
});
```

2\. Second useful method is `EasyAjax.update`. Use it if you want to easily load data and add it to some container.
`action_content` will be used to load data.

The code can look like this:
```
EasyAjax.update(location.href, {
"top.links": ".top-links-container",
"block.card":".top-card-container"
});
```

### RESTful requests

Instead of using easy_ajax=1 in params you can use RESTful interface and .json to action name.
Example: instead of `customer/account/loginPost?easy_ajax=1` you can use `customer/account/loginPost.json`

NOTE: This feature is disabled by default, to enable it just uncomment default/web/routers/json in config.xml

## Unit Tests

Unit Tests writing is in progress.
To run PHP tests use EcomDev_PHPUnit module.
To run Js file test use CasperJs.