referral_hero_flutter 0.0.5

A Flutter plugin for integrating ReferralHero API to manage referrals, contests, and rewards in your mobile applications.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:referral_hero_flutter/referral_hero_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Referral Hero Flutter Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  late ReferralHeroFlutter _referralHeroService;

  final apiKey = "API_KEY";
  final uuid = "UUID";

  @override
  void initState() {
    super.initState();
    _referralHeroService = ReferralHeroFlutter(apiKey, uuid);
  }

  String transformResolution(String? input) {
    if (input != null && input.contains("*")) {
      final dimensions = input.split('*').map((e) => e.trim()).toList();
      return '${dimensions[0]} x ${dimensions[1]}';
    }
    return input ?? "";
  }

  Future<void> _addSubscriber() async {
    final subscriber = {
      'email': '[e-mail]',
      'name': 'Test User 28',
      'phone_number': '[phone]',
      'domain': 'test.com',
      'device': await _referralHeroService.deviceInfo
          .getDeviceType(), // Get device type
      'ip_address': await _referralHeroService.deviceInfo
          .getIpAddress(), // Get IP address
      'os_type': await _referralHeroService.deviceInfo
          .getOperatingSystem(), // Get operating system type
      'screen_size': transformResolution(
          await _referralHeroService.deviceInfo.getDeviceScreenSize())
    };
    debugPrint("$subscriber");
    try {
      var result = await _referralHeroService.addSubscriber(subscriber);
      debugPrint(
          'Subscriber added successfully: ${result.id} ${result.name} ${result.email}');
    } catch (error) {
      debugPrint('Failed to add subscriber: $error');
    }
  }

  Future<void> _getSubscriberDetails() async {
    try {
      final details =
          await _referralHeroService.getSubscriberDetails('subscriberId');
      debugPrint(
          'Subscriber details: ${details.id} ${details.name} ${details.email}');
    } catch (error) {
      debugPrint('Failed to fetch subscriber details: $error');
    }
  }

  Future<void> _updateSubscriber() async {
    final updates = {
      'name': 'Updated Name',
    };
    try {
      var result =
          await _referralHeroService.updateSubscriber('subscriberId', updates);

      debugPrint(
          'Subscriber updated successfully: ${result.id} ${result.name} ${result.email}');
    } catch (error) {
      debugPrint('Failed to update subscriber: $error');
    }
  }

  Future<void> _deleteSubscriber() async {
    try {
      var result = await _referralHeroService.deleteSubscriber('subscriberId');
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Subscriber deleted successfully');
    } catch (error) {
      debugPrint('Failed to delete subscriber: $error');
    }
  }

  Future<void> _trackReferral() async {
    final referral = {
      'email': '[e-mail]',
      'name': 'Updated Name',
    };
    try {
      var result = await _referralHeroService.trackReferral(referral);
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Referral tracked successfully');
    } catch (error) {
      debugPrint('Failed to track referral: $error');
    }
  }

  Future<void> _captureShare() async {
    try {
      var result =
          await _referralHeroService.captureShare('subscriberId', 'facebook');
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Share captured successfully');
    } catch (error) {
      debugPrint('Failed to capture share: $error');
    }
  }

  Future<void> _getMyReferrals() async {
    try {
      final referrals =
          await _referralHeroService.getMyReferrals('subscriberId');
      debugPrint('Referrals: $referrals');
    } catch (error) {
      debugPrint('Failed to fetch referrals: $error');
    }
  }

  Future<void> _getLeaderboard() async {
    try {
      final leaderboard = await _referralHeroService.getLeaderboard();
      debugPrint('Leaderboard: $leaderboard');
    } catch (error) {
      debugPrint('Failed to fetch leaderboard: $error');
    }
  }

  Future<void> _createPendingReferral() async {
    final referral = {
      'email': '[e-mail]',
      'name': 'Pending User',
    };
    try {
      var result = await _referralHeroService.createPendingReferral(referral);
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Pending referral created successfully');
    } catch (error) {
      debugPrint('Failed to create pending referral: $error');
    }
  }

  Future<void> _organicTrackReferral() async {
    final referral = {
      'email': '[e-mail]',
      'name': 'Organic User',
    };
    try {
      var result = await _referralHeroService.organicTrackReferral(referral);
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Organic referral tracked successfully');
    } catch (error) {
      debugPrint('Failed to track organic referral: $error');
    }
  }

  Future<void> _confirmReferral() async {
    try {
      var result = await _referralHeroService.confirmReferral('subscriberId');
      if (result['status'] == 'error') {
        throw Exception(result['message']);
      }
      debugPrint('Referral confirmed successfully');
    } catch (error) {
      debugPrint('Failed to confirm referral: $error');
    }
  }

  Future<void> _getReferrer() async {
    final query = {
      'os_type': 'ios',
      'device': 'iPhone',
      'ip_address': '192.168.0.1',
      'screen_size': '1200x1800'
    };
    try {
      final referrer = await _referralHeroService.getReferrer(query);
      debugPrint('Referrer: $referrer');
    } catch (error) {
      debugPrint('Failed to get referrer: $error');
    }
  }

  Future<void> _getRewards() async {
    try {
      final rewards = await _referralHeroService.getRewards('subscriberId');
      debugPrint('Rewards: $rewards');
    } catch (error) {
      debugPrint('Failed to fetch rewards: $error');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Referral Hero Flutter Example'),
      ),
      body: Center(
        child: SingleChildScrollView(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: _addSubscriber,
                child: const Text('Add Subscriber'),
              ),
              ElevatedButton(
                onPressed: _getSubscriberDetails,
                child: const Text('Get Subscriber Details'),
              ),
              ElevatedButton(
                onPressed: _updateSubscriber,
                child: const Text('Update Subscriber'),
              ),
              ElevatedButton(
                onPressed: _deleteSubscriber,
                child: const Text('Delete Subscriber'),
              ),
              ElevatedButton(
                onPressed: _trackReferral,
                child: const Text('Track Referral'),
              ),
              ElevatedButton(
                onPressed: _captureShare,
                child: const Text('Capture Share'),
              ),
              ElevatedButton(
                onPressed: _getMyReferrals,
                child: const Text('Get My Referrals'),
              ),
              ElevatedButton(
                onPressed: _getLeaderboard,
                child: const Text('Get Leaderboard'),
              ),
              ElevatedButton(
                onPressed: _createPendingReferral,
                child: const Text('Create Pending Referral'),
              ),
              ElevatedButton(
                onPressed: _organicTrackReferral,
                child: const Text('Organic Track Referral'),
              ),
              ElevatedButton(
                onPressed: _confirmReferral,
                child: const Text('Confirm Referral'),
              ),
              ElevatedButton(
                onPressed: _getReferrer,
                child: const Text('Get Referrer'),
              ),
              ElevatedButton(
                onPressed: _getRewards,
                child: const Text('Get Rewards'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}