Download the PHP package chteuchteu/corporate-vcards-bundle without Composer
On this page you can find all versions of the php package chteuchteu/corporate-vcards-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download chteuchteu/corporate-vcards-bundle
More information about chteuchteu/corporate-vcards-bundle
Files in chteuchteu/corporate-vcards-bundle
Package corporate-vcards-bundle
Short Description Easily create professional looking vcards
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package corporate-vcards-bundle
CorporateVCardsBundle
This Bundle allows you to easily create simple & professional looking vcards:
Features
- Produces a set of webpages for each defined profile: (with a customizable prefix)
- /vcard/jppernaut
- /vcard/cchazal
- /vcard/pparvor
- On click, shows a QR Code containing all the profile information in the vcard vcf format
- Easily download the .vcf file to be opened in any contacts management tool
- Easily share the page by sending it as e-mail to a client, friend, relative, ...
Let's get started
To install this bundle inside your existent symfony2 project, follow these instructions:
-
Require this project
-
Register this bundle in symfony's kernel:
-
Configure routing:
-
Configure the bundle (see Defining profiles)
- Install assets:
Defining profiles
We're now ready to configure this bundle. The config node sets general configuration, while default and profiles
defines profiles-related information.
First, define define some - or none - default values using the default node. Then, create one or several profiles inside
the profiles node. A valid profile tree would look like this:
All these three nodes produces the following configuration tree view:
Warning: all URIs must be formatted as above (
@AppBundle/Resources/public/file.extvsbundles/app/file.extformat, trailing and leading slashes)
Mails
If enabled, a form will be shown on each vcard's page, allowing one to send the current vcard to an e-mail address.
You must handle sending the mail in your own bundle, by implementing the MailsServiceInterface's sendVcard function. It received three arguments:
$toMail: form-submitted e-mail address$profile: person's information:[ 'firstName' => 'John', 'lastName' => 'Doe', /* ... */ ]$person: person's name as defined in your config.yml file:jdoe
Favicons
Each profile can have custom favicons generated from its profile picture, using RealFaviconGenerator's API. In order to use this feature, you must generate your own Non-interactive API key here.
It is recommended to configure config.favicons.dir to be a directory in your own bundle, so you can add generated assets to source control.
Once run, the cvc:generate-favicons command will loop over each one of the configured profiles, and call RealFaviconGenerator's API
if the current profile has a photo and hasn't any generated favicons yet.
Note 1: you can force regenerating favicons for a profile by deleting its dir content
Note 2: you must execute this command if you add new profiles, change a photo, or rename a profile key.
Email protection
In order to protect profiles e-mail addresses against spammer robots, we "encrypt" them using ROT13 substitution cipher. Those are then decoded client-side using a simple javascript script. This technique is not meant to be perfect nor secure, but to avoid displaying clear e-mail addresses in the vcards HTML source.
Contribute
All contributions are welcomed! Please create your pull-requests against the master branch.
All versions of corporate-vcards-bundle with dependencies
symfony/symfony Version >=2.1.0
jeroendesloovere/vcard-bundle Version ^1.2
endroid/qrcode-bundle Version ^2.0