integer-net/magento2-addtocartgraphql

# IntegerNet_AddToCartGraphQl Magento Module
<div align="center">

[![Latest Version on Packagist][ico-version]][link-packagist]
[![Software License][ico-license]](LICENSE.md)
[![Build Status][ico-travis]][link-travis]
![Supported Magento Versions][ico-compatibility]

[![Coverage Status][ico-scrutinizer]][link-scrutinizer]
[![Quality Score][ico-code-quality]][link-code-quality]
[![Maintainability][ico-maintainability]][link-maintainability]
</div>

---

This module provides support to add products to cart via GraphQl. For this to be available for guests, it is needed to force quote creation, which is done upon first checkout session creation.

## Installation

1. Install it into your Magento 2 project with composer:
    ```
    composer require integer-net/magento2-addtocartgraphql
    ```

2. Enable module
    ```
    bin/magento setup:upgrade
    ```


For your reference, there is also an add to cart snippet included.  

## Usage

### Configurable Products (Hyvä)

Please mind: if you plan to use this for configurable products in the Hyvä theme, you need to pass the product selection to the addtocart component. 

The easiest way is to add a method to Magento_ConfigurableProduct/templates/product/view/type/options/js/configurable-options.phtml


        updateCurrentSelection() {
            window.dispatchEvent(
                new CustomEvent(
                    "update-currentSelection-" + this.productId,
                    {
                        detail: this.selectedValues
                    }
                )
            );
        },

This should be called whenever a selection is made, in Hyvä default you would prepend its call to the method

    changeOption(optionId, value) {
        [...]
        this.updateCurrentSelection()
    }

### Default Qty (Hyvä)

The default qty on init of add to cart button is set to 1 - ideally, you would rather change `Magento_Catalog/templates/product/view/quantity.phtml` to dispatch `updateChangeQty` on init, as addtocart component already listens to this event - this way, you would always get the correct default qty.

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

## Testing

### Unit Tests

```
./vendor/bin/phpunit tests/unit
```

### Magento Integration Tests

0. Configure test database in `dev/tests/integration/etc/install-config-mysql.php`. [Read more in the Magento docs.](https://devdocs.magento.com/guides/v2.4/test/integration/integration_test_execution.html) 

1. Copy `tests/integration/phpunit.xml.dist` from the package to `dev/tests/integration/phpunit.xml` in your Magento installation.

2. In that directory, run
    ``` bash
    ../../../vendor/bin/phpunit
    ```


## Security

If you discover any security related issues, please email security@integer-net.de instead of using the issue tracker.

## Credits

- [Lisa Buchholz][link-author]
- [All Contributors][link-contributors]

## License

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

[ico-version]: https://img.shields.io/packagist/v/integer-net/magento2-addtocartgraphql.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-travis]: https://img.shields.io/travis/integer-net/magento2-addtocartgraphql/master.svg?style=flat-square
[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/integer-net/magento2-addtocartgraphql?style=flat-square
[ico-code-quality]: https://img.shields.io/scrutinizer/g/integer-net/magento2-addtocartgraphql.svg?style=flat-square
[ico-maintainability]: https://img.shields.io/codeclimate/maintainability/integer-net/magento2-addtocartgraphql?style=flat-square
[ico-compatibility]: https://img.shields.io/badge/magento-2.4-brightgreen.svg?logo=magento&longCache=true&style=flat-square

[link-packagist]: https://packagist.org/packages/integer-net/magento2-addtocartgraphql
[link-travis]: https://travis-ci.org/integer-net/magento2-addtocartgraphql
[link-scrutinizer]: https://scrutinizer-ci.com/g/integer-net/magento2-addtocartgraphql/code-structure
[link-code-quality]: https://scrutinizer-ci.com/g/integer-net/magento2-addtocartgraphql
[link-maintainability]: https://codeclimate.com/github/integer-net/magento2-addtocartgraphql
[link-author]: https://github.com/lbuchholz
[link-contributors]: ../../contributors