🚀 Flutter Magento Plugin 2.0 #

Унифицированная Flutter библиотека для интеграции с Magento e-commerce платформой. Версия 2.0 устраняет дублирование кода между приложениями и предоставляет 200+ функций для создания современных мобильных коммерческих приложений.

✨ Новые возможности в версии 2.0 #

🎯 Унифицированная архитектура #

Устранение дублирования: Один API для всех приложений
Модульная структура: Используйте только нужные компоненты
Типобезопасность: Строгая типизация с Freezed моделями
Консистентность: Одинаковый подход во всех приложениях

🔐 Продвинутая аутентификация #

JWT токены с автоматическим обновлением
Безопасное хранение с FlutterSecureStorage
Поддержка "Запомнить меня"
Автоматическая валидация токенов
Обработка истечения сессии

🌐 Унифицированный сетевой слой #

Dio + HTTP клиент с автоматическими повторными попытками
Мониторинг подключения к интернету
Автоматическая обработка ошибок
Логирование запросов в debug режиме
Кэширование ответов

🌍 Система локализации #

45+ языков из коробки
Автоматическое определение системной локали
Поддержка множественного числа
RTL поддержка для арабского и иврита
Кастомные переводы

📱 Офлайн режим #

Автоматическое кэширование данных
Очередь операций для офлайн режима
SQLite + Hive для быстрого доступа
Автоматическая синхронизация при восстановлении сети
Настраиваемые стратегии кэширования

🎨 Управление состоянием #

Provider + ChangeNotifier паттерн
Готовые провайдеры для всех сервисов
Реактивные обновления UI
Централизованное управление состоянием

🛍️ Расширенная e-commerce функциональность #

Полная интеграция с Magento REST API
GraphQL поддержка для сложных запросов
Корзина с поддержкой гостевых пользователей
Wishlist с множественными списками
Продвинутый поиск и фильтрация

🚀 Getting Started #

Installation #

Add the dependency to your pubspec.yaml:

dependencies:
  flutter_magento: ^2.0.0

Быстрый старт #

import 'package:flutter_magento/flutter_magento.dart';
import 'package:provider/provider.dart';

void main() {
  runApp(
    MultiProvider(
      providers: [
        ChangeNotifierProvider(create: (_) => MagentoProvider()),
        ChangeNotifierProxyProvider<MagentoProvider, AuthProvider>(
          create: (context) => AuthProvider(context.read<MagentoProvider>().auth),
          update: (context, magentoProvider, previous) => 
              previous ?? AuthProvider(magentoProvider.auth),
        ),
      ],
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Consumer<MagentoProvider>(
        builder: (context, magento, child) {
          if (!magento.isInitialized) {
            return FutureBuilder(
              future: magento.initialize(
                baseUrl: 'https://your-magento-store.com',
                supportedLanguages: ['en', 'ru', 'de', 'fr', 'es'],
              ),
              builder: (context, snapshot) {
                if (snapshot.connectionState == ConnectionState.waiting) {
                  return Scaffold(body: Center(child: CircularProgressIndicator()));
                }
                return HomePage();
              },
            );
          }
          return HomePage();
        },
      ),
    );
  }
}

// Пример использования аутентификации
class LoginPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Consumer<AuthProvider>(
      builder: (context, auth, child) {
        return Scaffold(
          body: Column(
            children: [
              TextField(/* email field */),
              TextField(/* password field */),
              ElevatedButton(
                onPressed: auth.isLoading ? null : () async {
                  final success = await auth.authenticate(
                    email: emailController.text,
                    password: passwordController.text,
                    rememberMe: true,
                  );
                  if (success) {
                    Navigator.pushReplacementNamed(context, '/home');
                  }
                },
                child: auth.isLoading 
                    ? CircularProgressIndicator() 
                    : Text('Войти'),
              ),
            ],
          ),
        );
      },
    );
  }
}

📚 API Reference #

Authentication #

// Customer login
final authResponse = await magento.authenticateCustomer(
  email: 'customer@example.com',
  password: 'password123',
);

// Customer registration
final customer = await magento.createCustomer(
  email: 'new@example.com',
  password: 'password123',
  firstName: 'John',
  lastName: 'Doe',
);

// Get current customer
final currentCustomer = await magento.getCurrentCustomer();

// Logout
await magento.logout();

Products #

// Get products with filters
final products = await magento.getProducts(
  page: 1,
  pageSize: 20,
  searchQuery: 'phone',
  categoryId: '123',
  sortBy: 'price',
  sortOrder: 'asc',
  filters: {'brand': 'Apple'},
);

// Get single product
final product = await magento.getProduct('SKU123');

// Search products
final searchResults = await magento.searchProducts(
  'smartphone',
  page: 1,
  pageSize: 20,
);

// Get product reviews
final reviews = await magento.getProductReviews('SKU123');

Cart Management #

// Create cart
final cart = await magento.createCart();

// Add item to cart
final updatedCart = await magento.addToCart(
  cartId: cart.id!,
  sku: 'SKU123',
  quantity: 2,
);

// Get cart totals
final totals = await magento.getCartTotals(cart.id!);

// Apply coupon
final cartWithCoupon = await magento.applyCoupon(
  cartId: cart.id!,
  couponCode: 'SAVE20',
);

// Estimate shipping
final shippingMethods = await magento.estimateShipping(
  cartId: cart.id!,
  address: shippingAddress,
);

Orders #

// Get customer orders
final orders = await magento.getCustomerOrders(
  page: 1,
  pageSize: 20,
);

// Get order details
final order = await magento.getOrder('ORDER123');

// Get order status
final status = await magento.getOrderStatus('ORDER123');

// Cancel order
final cancelled = await magento.cancelOrder(
  'ORDER123',
  reason: 'Changed mind',
);

// Reorder
final newCart = await magento.reorder('ORDER123');

Wishlist #

// Get wishlist
final wishlist = await magento.getWishlist();

// Add to wishlist
final wishlistItem = await magento.addToDefaultWishlist(
  productId: '123',
);

// Remove from wishlist
final removed = await magento.removeFromDefaultWishlist(1);

// Share wishlist
final shared = await magento.shareDefaultWishlist(
  email: 'friend@example.com',
  message: 'Check out my wishlist!',
);

// Add all to cart
final addedToCart = await magento.addAllDefaultWishlistToCart();

Advanced Search #

// Advanced search
final searchResults = await magento.search(
  query: 'smartphone',
  filters: {'brand': 'Apple', 'price': '100-500'},
  page: 1,
  pageSize: 20,
  sortBy: 'price',
  sortOrder: 'asc',
);

// Search by category
final categoryResults = await magento.searchByCategory(
  categoryId: '123',
  query: 'phone',
);

// Search by attribute
final attributeResults = await magento.searchByAttribute(
  attribute: 'brand',
  value: 'Apple',
);

// Get search suggestions
final suggestions = await magento.getSearchSuggestions('smart');

// Get filterable attributes
final attributes = await magento.getFilterableAttributes();

// Apply price filter
final priceFiltered = await magento.applyPriceFilter(
  minPrice: 100.0,
  maxPrice: 500.0,
);

🏗️ Architecture #

The plugin follows a clean architecture pattern with the following layers:

API Layer: HTTP client with Dio, REST API integration
Service Layer: Business logic and data processing
Model Layer: Data models with JSON serialization
Plugin Layer: Flutter plugin interface

Directory Structure #

lib/
├── src/
│   ├── api/           # API classes
│   │   ├── auth_api.dart
│   │   ├── product_api.dart
│   │   ├── cart_api.dart
│   │   ├── order_api.dart
│   │   ├── wishlist_api.dart
│   │   └── search_api.dart
│   ├── models/        # Data models
│   │   ├── auth_models.dart
│   │   ├── product_models.dart
│   │   ├── cart_models.dart
│   │   ├── order_models.dart
│   │   ├── wishlist_models.dart
│   │   └── search_models.dart
│   └── flutter_magento_plugin.dart
├── flutter_magento.dart
└── flutter_magento_platform_interface.dart

🔧 Configuration #

Environment Setup #

// Development
await magento.initialize(
  baseUrl: 'https://dev-store.com',
  connectionTimeout: 30000,
  receiveTimeout: 30000,
);

// Production
await magento.initialize(
  baseUrl: 'https://store.com',
  headers: {
    'X-API-Key': 'your-api-key',
    'X-Store-Code': 'default',
  },
);

Custom Headers #

await magento.initialize(
  baseUrl: 'https://store.com',
  headers: {
    'Authorization': 'Bearer token',
    'Accept-Language': 'en-US',
    'X-Custom-Header': 'value',
  },
);

🧪 Testing #

# Run tests
flutter test

# Run tests with coverage
flutter test --coverage

# Generate code
flutter packages pub run build_runner build --delete-conflicting-outputs

📱 Platform Support #

✅ Android
✅ iOS
✅ Web
✅ Windows
✅ macOS
✅ Linux

🔒 Security Features #

JWT token authentication
HTTPS enforcement
Input validation and sanitization
Secure token storage
Rate limiting support
CSRF protection

📊 Performance Features #

Request caching
Image optimization
Lazy loading support
Offline mode
Background sync
Memory management

🤝 Contributing #

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support #

📧 Email: support@nativemind.net
🐛 Issues: GitHub Issues
📚 Documentation: Wiki
💬 Community: Discord

🙏 Acknowledgments #

Magento team for the excellent e-commerce platform
Flutter team for the amazing framework
ScandiPWA team for inspiration and best practices
All contributors and community members

Made with ❤️ by NativeMind Team

flutter_magento 2.3.4 flutter_magento: ^2.3.4 copied to clipboard

Metadata