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
boolfromConfig()
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
selfgetOrganizationId()
Organization ID getter (sometimes useful for display/debugging).
public
getOrganizationId() : int|null
Return values
int|nullgetOrganizationName()
Organization name getter (fallback value).
public
getOrganizationName() : string|null
Return values
string|nullbuildQuery()
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
stringclamp()
private
clamp(int $value, int $min, int $max) : int
Parameters
- $value : int
- $min : int
- $max : int
Return values
intescapeAttr()
private
escapeAttr(string $value) : string
Parameters
- $value : string