Tsugi

LinkedIn
in package

LinkedIn integration helpers for "Add to profile" (Licenses & Certifications).

Key rule (learned the hard way):

  • Use organizationId (numeric) to get the LinkedIn Company Page logo.
  • Do NOT use organizationName in the add URL, or you risk the generic icon.
  • Falls back to organizationName if organizationId is not available.

Table of Contents

Constants

DEFAULT_START_TASK  : mixed = 'CERTIFICATION_NAME'

Properties

$organizationId  : int|null
$organizationName  : string|null

Methods

__construct()  : mixed
Create LinkedIn helper instance.
buildAddCertificationUrl()  : string|null
Build a LinkedIn "Add certification" URL.
buildOb2HeadLinkTags()  : array<string|int, mixed>
Produce HTML <link> tags that help crawlers discover the OB2 assertion JSON.
canAddToProfile()  : bool
True when Add to Profile can name an organization.
fromConfig()  : self
Create LinkedIn helper from CFG configuration.
getOrganizationId()  : int|null
Organization ID getter (sometimes useful for display/debugging).
getOrganizationName()  : string|null
Organization name getter (fallback value).
buildQuery()  : string
RFC3986 encoding (spaces => %20). Plays nicest with strict parsers.
clamp()  : int
escapeAttr()  : string

Constants

DEFAULT_START_TASK

public mixed DEFAULT_START_TASK = 'CERTIFICATION_NAME'

Properties

$organizationId

private int|null $organizationId

$organizationName

private string|null $organizationName

Methods

__construct()

Create LinkedIn helper instance.

public __construct([int|null $organizationId = null ][, string|null $organizationName = null ]) : mixed
Parameters
$organizationId : int|null = null

LinkedIn organization ID (preferred)

$organizationName : string|null = null

Organization name (fallback if organizationId not set)

buildAddCertificationUrl()

Build a LinkedIn "Add certification" URL.

public buildAddCertificationUrl(string $name, string $certUrl[, string|null $certId = null ][, int|null $issueYear = null ][, int|null $issueMonth = null ][, string|null $startTask = self::DEFAULT_START_TASK ]) : string|null
Parameters
$name : string

Certification name (badge title)

$certUrl : string

Public credential URL (your HTML credential page)

$certId : string|null = null

Credential ID (e.g., "3f022") - optional

$issueYear : int|null = null

4-digit year - optional

$issueMonth : int|null = null

1-12 - optional

$startTask : string|null = self::DEFAULT_START_TASK

Usually CERTIFICATION_NAME (optional)

Return values
string|null —

Returns URL if organization info is available, null otherwise

buildOb2HeadLinkTags()

Produce HTML <link> tags that help crawlers discover the OB2 assertion JSON.

public buildOb2HeadLinkTags(string $assertionJsonUrl, string $canonicalUrl) : array<string|int, mixed>

Returns the tag strings (already HTML-escaped) so you can echo them in .

Parameters
$assertionJsonUrl : string

e.g. https://.../assertions/.json

$canonicalUrl : string

e.g. https://.../assertions/

Return values
array<string|int, mixed>

canAddToProfile()

True when Add to Profile can name an organization.

public canAddToProfile() : bool
Return values
bool

fromConfig()

Create LinkedIn helper from CFG configuration.

public static fromConfig(object $CFG) : self
Parameters
$CFG : object

Configuration object with linkedin_organization_id and badge_organization

Return values
self

getOrganizationId()

Organization ID getter (sometimes useful for display/debugging).

public getOrganizationId() : int|null
Return values
int|null

getOrganizationName()

Organization name getter (fallback value).

public getOrganizationName() : string|null
Return values
string|null

buildQuery()

RFC3986 encoding (spaces => %20). Plays nicest with strict parsers.

private buildQuery(array<string|int, mixed> $params) : string
Parameters
$params : array<string|int, mixed>
Return values
string

clamp()

private clamp(int $value, int $min, int $max) : int
Parameters
$value : int
$min : int
$max : int
Return values
int

escapeAttr()

private escapeAttr(string $value) : string
Parameters
$value : string
Return values
string

        
On this page

Search results