0 purchases
vcard
vCard #
Create vCards to import contacts into Outlook, iOS, Mac OS, and Android devices from your website or mobile application.
Install #
To use this package, add vcard as a dependency in your pubspec.yaml file like so.
dependencies:
vcard: any
copied to clipboard
Then run the flutter tooling:
flutter packages get
copied to clipboard
Usage #
Below is a simple example of how to create a basic vCard and how to save it to a file, or view its contents from the console.
/// Import the package
import 'package:vcard/vcard.dart';
///Create a new vCard
var vCard = VCard();
///Set properties
vCard.firstName = 'FirstName';
vCard.middleName = 'MiddleName';
vCard.lastName = 'LastName';
vCard.organization = 'ActivSpaces Labs';
vCard.photo.attachFromUrl('/path/to/image/file.png', 'PNG');
vCard.workPhone = 'Work Phone Number';
vCard.birthday = DateTime.now();
vCard.title = 'Software Developer';
vCard.url = 'https://github.com/valerycolong';
vCard.note = 'Notes on contact';
/// Save to file
vCard.saveToFile('./contact.vcf');
/// Get as formatted string
print(vCard.getFormattedString());
copied to clipboard
Embedding Images #
You can embed images in the photo or logo field instead of linking to them from a URL using base64 encoding.
//can be Windows or Linux/Unix path structures, and JPEG, PNG, GIF formats
vCard.photo.embedFromFile('/path/to/file.png');
vCard.logo.embedFromFile('/path/to/file.png');
copied to clipboard
//can also embed images via base-64 encoded strings
vCard.photo.embedFromString('iVBORw0KGgoAAAANSUhEUgAAA2...', 'image/png');
vCard.logo.embedFromString('iVBORw0KGgoAAAANSUhEUgAAA2...', 'image/png');
copied to clipboard
Date Reference #
MDN reference on how to use the Date object for birthday and anniversary can be found at https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date.
Complete Example #
The following shows a vCard with everything filled out.
///import the package
import 'package:vcard/vcard.dart';
//create a new vCard
var vCard = VCard();
///set basic properties shown before
vCard.firstName = 'FirstName';
vCard.middleName = 'MiddleName';
vCard.lastName = 'Last Name';
vCard.uid = '6yuuhuhj-c34d-4a1e-8922-bd38a9476a53';
vCard.organization = 'ActivSpaces Labs';
///link to image
vCard.photo.attachFromUrl('/path/to/image/file.png', 'JPEG');
///or embed image
vCard.photo.attachFromUrl('/path/to/image/file.png');
vCard.workPhone = '312-555-1212';
vCard.birthday = DateTime.now();
vCard.title = 'Software Developer';
vCard.url = 'https://github.com/valerycolong';
vCard.workUrl = 'https://activspaces.com';
vCard.note = 'Notes on contact';
///set other vitals
vCard.nickname = 'Scarface';
vCard.namePrefix = 'Mr.';
vCard.nameSuffix = 'JR';
vCard.gender = 'M';
vCard.anniversary = DateTime.now();
vCard.role = 'Software Development';
///set other phone numbers
vCard.homePhone = 'Home Phone';
vCard.cellPhone = 'Cell Phone';
vCard.pagerPhone = 'Pager Phone';
///set fax/facsimile numbers
vCard.homeFax = 'Home Fax';
vCard.workFax = 'Work Fax';
///set email addresses
vCard.email = '[email protected]';
vCard.workEmail = '[email protected]';
///set logo of organization or personal logo (also supports embedding, see above)
vCard.logo.attachFromUrl('https://www.activspaces.com/wp-content/uploads/2019/01/ActivSpaces-Logo_Dark.png', 'PNG');
///set URL where the vCard can be found
vCard.source = 'http://example.com/myvcard.vcf';
///set address information
vCard.homeAddress.label = 'Home Address';
vCard.homeAddress.street = 'Great Soppo';
vCard.homeAddress.city = 'Buea';
vCard.homeAddress.stateProvince = 'SW';
vCard.homeAddress.postalCode = '00237';
vCard.homeAddress.countryRegion = 'Cameroon';
vCard.homeAddress.type = 'HOME';
vCard.workAddress.label = 'Work Address';
vCard.workAddress.street = 'Molyko';
vCard.workAddress.city = 'Buea';
vCard.workAddress.stateProvince = 'SW';
vCard.workAddress.postalCode = '00237';
vCard.workAddress.countryRegion = 'Cameroon';
vCard.workAddress.type = 'WORK';
///set social media URLs
vCard.socialUrls['facebook'] = 'https://...';
vCard.socialUrls['linkedIn'] = 'https://...';
vCard.socialUrls['twitter'] = 'https://...';
vCard.socialUrls['flickr'] = 'https://...';
vCard.socialUrls['custom'] = 'https://...';
///you can also embed photos from files instead of attaching via URL
vCard.photo.embedFromFile('photo.jpg');
vCard.logo.embedFromFile('logo.jpg');
vCard.version = '3.0'; //can also support 2.1 and 4.0, certain versions only support certain fields
///save to file
vCard.saveToFile('./contact/file.vcf');
///get as formatted string
print(vCard.getFormattedString());
copied to clipboard
Multiple Email, Fax, & Phone Examples #
email, otherEmail, cellPhone, pagerPhone, homePhone, workPhone, homeFax, workFax, otherPhone all support multiple entries in an array format.
Examples are provided below:
///import the package
import 'package:vcard/vcard.dart';
//create a new vCard
var vCard = VCard();
///multiple email entry
vCard.email = [
'[email protected]',
'[email protected]',
'[email protected]'
];
///multiple cellphone
vCard.cellPhone = [
'312-555-1414',
'312-555-1415',
'312-555-1416'
];
copied to clipboard
Apple AddressBook Extensions #
You can mark as a contact as an organization with the following Apple AddressBook extension property:
var vCard = VCard();
vCard.isOrganization = true;
copied to clipboard
Original Source #
This is a dart port of vCards-js package by Eric J Nesser
https://github.com/enesser/vCards-js
Testing #
You can run the VCard unit tests via (WIP):
flutter test
copied to clipboard
Credits #
Contributions are always welcome!
Thanks to Eric whose original work made life so much easier for me.
Eric J Nesser (https://github.com/enesser)
Dependencies #
This package depends on:
validators (https://pub.dev/packages/validators)
path_provider (https://pub.dev/packages/path_provider)
path (https://pub.dev/packages/path)
intl (https://pub.dev/packages/intl)
meta (https://pub.dev/packages/meta)
Contributions #
Contributions are always welcome!
Work with us #
[email protected]
License #
Copyright (c)2019 ActivSpaces Labs MIT
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
There are no reviews.