jeroendesloovere/vcard

This VCard PHP class can generate a vCard with some data. When using an iOS device it will export as a .ics file because iOS devices don't support the default .vcf files.

Wednesday, July 4, 2018
by jeroendesloovere
Repository
19 Watchers
205 Stars
206,943 Installations

PHP
2 Dependents
0 Suggesters
81 Forks
9 Open issues
39 Versions
13 % Grown

The README.md

VCard PHP library

, _(*1)

This VCard PHP library can generate a vCard with some data. When using an iOS device < iOS 8 it will export as a .ics file because iOS devices don't support the default .vcf files., _(*2)

NOTE: We are working on a complete new version to work with vCard version 4.0, with extreme good code quality. Check out the new version, _(*3)

Usage

Installation

composer require jeroendesloovere/vcard

This will install the latest version of vcard with Composer, _(*4)

Example

``` php use JeroenDesloovere\VCard\VCard;, _(*5)

// define vcard $vcard = new VCard();, _(*6)

// define variables $lastname = 'Desloovere'; $firstname = 'Jeroen'; $additional = ''; $prefix = ''; $suffix = '';, _(*7)

// add personal data $vcard->addName($lastname, $firstname, $additional, $prefix, $suffix);, _(*8)

// add work data $vcard->addCompany('Siesqo'); $vcard->addJobtitle('Web Developer'); $vcard->addRole('Data Protection Officer'); $vcard->addEmail('info@jeroendesloovere.be'); $vcard->addPhoneNumber(1234121212, 'PREF;WORK'); $vcard->addPhoneNumber(123456789, 'WORK'); $vcard->addAddress(null, null, 'street', 'worktown', null, 'workpostcode', 'Belgium'); $vcard->addLabel('street, worktown, workpostcode Belgium'); $vcard->addURL('http://www.jeroendesloovere.be');, _(*9)

$vcard->addPhoto(DIR . '/landscape.jpeg');, _(*10)

// return vcard as a string //return $vcard->getOutput();, _(*11)

// return vcard as a download return $vcard->download();, _(*12)

// save vcard on disk //$vcard->setSavePath('/path/to/directory'); //$vcard->save();, _(*13)


> [View all examples](/examples/example.php) or check [the VCard class](/src/VCard.php).

### Parsing examples

The parser can either get passed a VCard string, like so:

```php
// load VCardParser classes
use JeroenDesloovere\VCard\VCardParser;

$parser = new VCardParser($vcardString);
echo $parser->getCardAtIndex(0)->fullname; // Prints the full name.

Or by using a factory method with a file name:, _(*14)

$parser = VCardParser::parseFromFile('path/to/file.vcf');
echo $parser->getCardAtIndex(0)->fullname; // Prints the full name.

View the parsing example or check the the VCardParser class class., _(*15)

Support for frameworks, _(*16)

I've created a Symfony Bundle: VCard Bundle, _(*17)

Usage in for example: Laravel, _(*18)

return Response::make(
    $this->vcard->getOutput(),
    200,
    $this->vcard->getHeaders(true)
);

Tests

vendor/bin/phpunit tests

Documentation

The class is well documented inline. If you use a decent IDE you'll see that each method is documented with PHPDoc., _(*19)

Contributing

Contributions are welcome and will be fully credited., _(*20)

Pull Requests

To add or update code, _(*21)

Coding Syntax - Please keep the code syntax consistent with the rest of the package.
Add unit tests! - Your patch won't be accepted if it doesn't have tests.
Document any change in behavior - Make sure the README and any other relevant documentation are kept up-to-date.
Consider our release cycle - We try to follow semver. Randomly breaking public APIs is not an option.
Create topic branches - Don't ask us to pull from your master branch.
One pull request per feature - If you want to do more than one thing, send multiple pull requests.
Send coherent history - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.

Issues

For bug reporting or code discussions., _(*22)

More info on how to work with GitHub on help.github.com., _(*23)

Credits

License

The module is licensed under MIT. In short, this license allows you to do everything as long as the copyright statement stays present., _(*24)

The Versions

04/07 2018

dev-master

9999999-dev https://github.com/jeroendesloovere/vcard

This VCard PHP class can generate a vCard with some data. When using an iOS device it will export as a .ics file because iOS devices don't support the default .vcf files.

library vcard

This VCard PHP class can generate a vCard with some data. When using an iOS device it will export as a .ics file because iOS devices don't support the default .vcf files.

jeroendesloovere/vcard

The README.md

VCard PHP library

Usage

Installation

Example

Tests

Documentation

Contributing

Pull Requests

Issues

Credits

License

The Versions

dev-master

The Requires

The Development Requires

by Jeroen Desloovere

1.7.1

The Requires

The Development Requires

by Jeroen Desloovere

1.7.0

The Requires

The Development Requires

by Jeroen Desloovere

dev-alternative-for-file_get_contents

The Requires

The Development Requires

by Jeroen Desloovere

dev-2.0.0-dev

The Requires

The Development Requires

by Jeroen Desloovere

dev-rename-parseLine-to-parseVcfString

The Requires

The Development Requires

by Jeroen Desloovere

dev-scrutinizer-patch-1

The Requires

The Development Requires

by Jeroen Desloovere

dev-new-version

The Requires

The Development Requires

by Jeroen Desloovere

1.6

The Requires

The Development Requires

by Jeroen Desloovere

dev-Jean-Beru-feature/label-property

The Requires

The Development Requires

by Jeroen Desloovere

1.5.2

The Requires

The Development Requires

by Jeroen Desloovere

dev-phpdoc-update

The Requires

The Development Requires

by Jeroen Desloovere

1.5.1

The Requires

The Development Requires

by Jeroen Desloovere

1.5.0

The Requires

The Development Requires

by Jeroen Desloovere

1.4.0

The Requires

The Development Requires

by Jeroen Desloovere

dev-minhazul-haque-master

The Requires

The Development Requires

by Jeroen Desloovere