Merge pull request #32 from mercadopago/release/1.11.0

v1.11.0

Author: SalehKhalilMP

.github/pull_request_template.md

@@ -1,32 +1,54 @@
 ## 📝 Descrição
 
-> Descrição do PR. Pode ser a mesma descrição da task/história do JIRA.
-> [#PSW-1234](jira.link.com)
+Por favor, explique as mudanças que você fez aqui.
 
-## 🎯 Objetivos do PR
+## 🕵️  Testes
 
-> Como o problema foi resolvido funcionalmente e técnicamente
-> Se aplicável uma lista de:
-> - [ ] O que falta fazer para cumprir a história
-> - [x] O que está sendo feito em outras tasks da história
-> - [x] O que foi feito neste PR para completar a história
+<!-- Adicionada evidência de teste, impressões, como prova ou algo que você pensa em testar seu código -->
 
-## 📸 Screenshots
+## 🎯 Tipo de PR
 
-> - Antes e depois, se for um fix
-> - Novas telas de novas funcionalidades
+<!-- Não envie atualizações para as dependências, a menos que isso corrija um problema. -->
 
-## 🧰 Como reproduzir
+<!-- Tente limitar sua solicitação pull a um tipo, envie várias solicitações pull, se necessário. -->
 
-> - Passo a passo de como testar
-> - Links para documentações externas
+Por favor, verifique o tipo de mudança que seu PR introduz:
 
-<!--  Items opcionais
+- [ ] Correção de bug
+- [ ] Feature
+- [ ] Atualização de Lib e dependências
+- [ ] Atualização de estilo de código (formatação, renomeação)
+- [ ] Refatoração (sem alterações funcionais, sem alterações de API)
+- [ ] Alterações no conteúdo da documentação
+- [ ] Correção de vulnerabilidade
+- [ ] Testes E2E
+- [ ] Outro (descreva):
+
+## 🚨 Checklist
+
+- [ ] Código compila corretamente
+- [ ] Testes criados que falham sem a alteração (se possível)
+- [ ] Todos os testes passando
+- [ ] Atualizar o README / CHANGELOG / Documentação / Swagger / Fury Docs / Confluence (se necessário)
+
+## 🧰 Qual é o comportamento atual?
+
+<!-- Descreva o comportamento atual que você está modificando ou crie um link para um problema relevante. -->
+
+Link da tarefa: N/A
+
+<!-- Itens opcionais
 ## 🔗 Links
 > - [link1.com](https://)
 > - [link2.com](https://)
 
 ## 🔀 PRs relacionados
 > - #123
 > - #321
--->
+-->
+
+---
+
+❤️ Obrigado!
+
+Ei revisor! Veja nossos 5 pilares de revisão: https://mercadolibre.atlassian.net/wiki/spaces/PLU/pages/2240021388/Processo+de+Revis+o+de+C+digo

.gitignore

@@ -4,6 +4,7 @@ testdoc.txt
 .idea
 coverage/
 test-results
+.vscode
 
 build/.env
 build/logs

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.11.0] - 2025-07-21
+### Added
+- Add option in the admin to change the order of address lines
+- Add end-to-end testing
+
+### Changed
+- Change the display of taxes for installment in Argentina
+
 ## [1.10.1] - 2025-06-18
 ### Fixed
 - Correction of discount calculation in CHOPRO processing

Makefile

@@ -31,6 +31,7 @@ install:
 	$(DOCKER_COMPOSE) -f build/docker-compose.yaml up -d && \
 	sleep 8 && \
 	docker exec -it magento_php composer require mp-plugins/php-sdk ^3.3 && \
+	docker exec -it magento_php composer require n98/magerun2-dist && \
 	docker exec -it magento_php php ./bin/magento setup:install \
 		--base-url=http://magento.local \
 		--db-host=database \

Model/Adminhtml/Source/AddressLine.php

@@ -0,0 +1,32 @@
+<?php
+/**
+ * Copyright © MercadoPago. All rights reserved.
+ *
+ * @author      Mercado Pago
+ * @license     See LICENSE for license details.
+ */
+
+namespace MercadoPago\AdbPayment\Model\Adminhtml\Source;
+
+use Magento\Framework\Option\ArrayInterface;
+
+/**
+ * Address line options for configuration.
+ */
+class AddressLine implements ArrayInterface
+{
+    /**
+     * Returns Options.
+     *
+     * @return array
+     */
+    public function toOptionArray(): array
+    {
+        return [
+            ['value' => '0', 'label' => __('Address Line 1')],
+            ['value' => '1', 'label' => __('Address Line 2')],
+            ['value' => '2', 'label' => __('Address Line 3')],
+            ['value' => '3', 'label' => __('Address Line 4')],
+        ];
+    }
+}

Plugin/AddressConfigValidation.php

@@ -0,0 +1,101 @@
+<?php
+/**
+ * Copyright © MercadoPago. All rights reserved.
+ *
+ * @author      Mercado Pago
+ * @license     See LICENSE for license details.
+ */
+
+namespace MercadoPago\AdbPayment\Plugin;
+
+use Magento\Config\Model\Config;
+use Magento\Framework\Exception\LocalizedException;
+
+class AddressConfigValidation
+{
+    /**
+     * Address configuration fields to validate.
+     */
+    private const ADDRESS_FIELDS = [
+        'street_name',
+        'street_number',
+        'complement',
+        'neighborhood'
+    ];
+
+    public function beforeSave(Config $subject)
+    {
+        $section = $subject->getSection();
+
+        if ($section !== 'payment') {
+            return [];
+        }
+
+        $addressLines = $this->extractAddressLines($subject);
+
+        if (!$addressLines) {
+            return [];
+        }
+
+        $this->validateAddressLinesConfig($addressLines);
+
+        return [];
+    }
+
+    private function extractAddressLines(Config $subject): ?array
+    {
+        return $subject->getData()['groups']['mercadopago_base']['groups']['basic_settings']['groups']['address_lines']['fields'] ?? null;
+    }
+
+    /**
+     * Validate address configuration for duplicates.
+     *
+     * @param array $addressLines
+     *
+     * Example: [
+     *  'street_name' => [
+     *      'value' => '0',
+     *  ],
+     *  'street_number' => [
+     *      'value' => '1',
+     *  ],
+     *  'complement' => [
+     *      'value' => '2',
+     *  ],
+     *  'neighborhood' => [
+     *      'value' => '3',
+     *  ],
+     * ]
+     *
+     * @return void
+     * @throws LocalizedException
+     */
+    private function validateAddressLinesConfig(array $addressLines): void
+    {
+        $valueFieldMap = [];
+        $duplicates = [];
+
+        foreach (self::ADDRESS_FIELDS as $field) {
+            if (isset($addressLines[$field]['value'])) {
+                $value = $addressLines[$field]['value'];
+
+                if (isset($valueFieldMap[$value])) {
+                    $duplicates[] = __(
+                        'Address Line %1 is selected for both "%2" and "%3"',
+                        strval(intval($value) + 1),
+                        $field,
+                        $valueFieldMap[$value]
+                    );
+                } else {
+                    $valueFieldMap[$value] = $field;
+                }
+            }
+        }
+
+        if (!empty($duplicates)) {
+            throw new LocalizedException(
+                __('Address configuration error: %1', implode(', ', $duplicates))
+            );
+        }
+    }
+}

build/docker-compose.yaml

@@ -63,6 +63,8 @@ services:
                 magento_version: ${MAGENTO_VERSION}
         container_name: magento_php
         image: php-magento-mp
+        environment:
+            XDEBUG_MODE: '${XDEBUG_MODE:-debug}'
         volumes:
             - magento-php-volume:/var/www/html
             - ./credentials:/home/ubuntu/.composer

build/php/Dockerfile-7.2

@@ -11,8 +11,6 @@ ENV HOST_OS=$host_os
 ARG magento_version
 ENV MAGENTO_VERSION=$magento_version
 
-COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
-
 RUN useradd -m $USERNAME \
     && chown -R $USERNAME:$USERNAME /var/www/html
 
@@ -33,6 +31,8 @@ RUN composer create-project -vvv --repository-url=https://repo.magento.com/ mage
 
 COPY ./build/credentials/auth.json /var/www/html/var/composer_home/auth.json
 
+COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
+
 USER root
 
 RUN chown -R $USERNAME:$USERNAME /var/www/html/var/composer_home

build/php/Dockerfile-7.4

@@ -11,8 +11,6 @@ ENV HOST_OS=$host_os
 ARG magento_version
 ENV MAGENTO_VERSION=$magento_version
 
-COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
-
 RUN useradd -m $USERNAME \
     && chown -R $USERNAME:$USERNAME /var/www/html
 
@@ -33,6 +31,8 @@ RUN composer create-project -vvv --repository-url=https://repo.magento.com/ mage
 
 COPY ./build/credentials/auth.json /var/www/html/var/composer_home/auth.json
 
+COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
+
 USER root
 
 RUN chown -R $USERNAME:$USERNAME /var/www/html/var/composer_home

build/php/Dockerfile-8.1

@@ -11,8 +11,6 @@ ENV HOST_OS=$host_os
 ARG magento_version
 ENV MAGENTO_VERSION=$magento_version
 
-COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
-
 RUN useradd -m $USERNAME \
     && chown -R $USERNAME:$USERNAME /var/www/html
 
@@ -33,6 +31,8 @@ RUN composer create-project -vvv --repository-url=https://repo.magento.com/ mage
 
 COPY ./build/credentials/auth.json /var/www/html/var/composer_home/auth.json
 
+COPY ./build/php/conf/xdebug-${HOST_OS}.ini $PHP_CONFIG_PATH/mods-available/xdebug.ini
+
 USER root
 
 RUN chown -R $USERNAME:$USERNAME /var/www/html/var/composer_home