elouafidev/vcf-generator

一个简单的 Laravel VCF 生成器。

1.0.3 2024-08-11 17:48 UTC

This package is auto-updated.

Last update: 2024-09-11 17:58:39 UTC


README

Latest Version on Packagist Total Downloads License

这是一个简单的 VCF(vCard)生成器,适用于 Laravel。此包为 Laravel 应用中的联系人生成 VCF 文件提供了一种简单的方法。它支持添加各种联系人信息,如全名、电子邮件地址、电话号码、地址、社交媒体资料等。

安装

您可以通过 composer 安装此包

composer require elouafidev/vcf-generator

用法

以下是如何在 Laravel 项目中使用 VCF 生成器的一个简单示例

use ElouafiDev\VCFGenerator\VCFGenerator;

$vcf = new VCFGenerator();
$vcf->setFullName('John Doe')
    ->setEmail('john.doe@example.com', VCFGenerator::WORK)
    ->setPhoneNumber('+123456789', VCFGenerator::WORK)
    ->setAddress('123 Main St, Anytown, USA')
    ->setTitle('Software Engineer')
    ->setDescription('Experienced software engineer with a passion for developing innovative programs.')
    ->setProfileImage150x150('/path/to/image.png')
    ->setFacebook('https://facebook.com/johndoe')
    ->setTwitter('https://twitter.com/johndoe')
    ->setLinkedin('https://linkedin.com/in/johndoe')
    ->setYoutube('https://youtube.com/johndoe')
    ->setInstagram('https://instagram.com/johndoe')
    ->setWebsite('https://johndoe.com')
    ->setSkype('johndoe');

return $vcf->download();

方法

  • setFullName(string $full_name): self
  • setEmail(string $email, string $type): self
  • setPhoneNumber(string $phone, string $type): self
  • setAddress(string $address): self
  • setTitle(string $title): self
  • setDescription(string $description): self
  • setProfileImage150x150(string $profile_image_150x150): self
  • setFacebook(string $url): self
  • setTwitter(string $url): self
  • setLinkedin(string $url): self
  • setYoutube(string $url): self
  • setInstagram(string $url): self
  • setWebsite(string $url): self
  • setSkype(string $url): self
  • vcfContent(): string
  • toBase64(): string
  • toUri(): string
  • download()
  • validateEmail(string $email): bool
  • validatePhoneNumber(string $phone): bool
  • clear(): self
  • setAttributes(array $attributes): self

示例

生成 VCF 内容

$vcfContent = $vcf->vcfContent();
echo $vcfContent;

获取 Base64 格式的 VCF

$vcfBase64 = $vcf->toBase64();
echo $vcfBase64;

获取数据 URI 格式的 VCF

$vcfUri = $vcf->toUri();
echo $vcfUri;

贡献

请参阅 CONTRIBUTING 以获取详细信息。

许可

MIT 许可证(MIT)。请参阅 许可文件 以获取更多信息。

作者

Mouad Elouafi