PHP download

Download the PHP package clesson-de/silverstripe-contacts without Composer

On this page you can find all versions of the php package clesson-de/silverstripe-contacts. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download clesson-de/silverstripe-contacts
More information about clesson-de/silverstripe-contacts
Files in clesson-de/silverstripe-contacts

Vendor clesson-de
Package silverstripe-contacts
Short Description All contacts and addresses at one place.
License BSD-3-Clause

Keywords address extension contact silverstripe member

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

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.

Please rate this library. Is it a good library?

Example code of clesson-de/silverstripe-contacts

Informations about the package silverstripe-contacts

Silverstripe Contacts Module

A central, flexible contact management system for Silverstripe 6. Manage companies, persons, and employees in a unified type hierarchy — complete with addresses, tags, customer numbers, payment accounts, avatars, and vCard export.

Features

Contact type hierarchy — abstract base class Contact with concrete subclasses Company, Person, and Employee
Company — stores company name and optional suffix
Person — stores gender, title, first/last name, nickname, birthday, marital status, and more
Employee — links a Person to a Company, representing a working relationship
One address per contact — each contact type has a single has_one Address relation; the semantic address type (home, business, work) is implied by the contact type
Tag system — assign contacts to one or more groups via ContactTag
Payment accounts — link bank accounts, credit cards, and online accounts via ContactPaymentAccountsExtension (requires clesson-de/silverstripe-payment-accounts)
Customer numbers — auto-generated from a configurable template with date parts and random segments; only assigned to contacts in the CUSTOMER tag group
Avatar upload — image upload with initials fallback
vCard download — export any contact as a .vcf file (requires DOWNLOAD_CONTACTS permission)
CMS member linking — optionally link a contact to a Silverstripe Member account
Website owner — designate one contact as the site owner, accessible globally in templates
Permissions — fine-grained CMS permissions (USE_CONTACTS, DOWNLOAD_CONTACTS)
Extensible CMS layout — sidebar + main tabs layout with extension hooks
Delete protection — Company and Person records linked to an Employee cannot be deleted

Requirements

Dependency	Version
PHP	`^8.1`
silverstripe/framework	`^6`
clesson-de/silverstripe-geocoding	`^1`
clesson-de/silverstripe-payment-accounts	`^1`
jeroendesloovere/vcard	`^1.7`
giggsey/libphonenumber-for-php	`^8.13`
lekoala/silverstripe-cms-actions	`^2`
symbiote/silverstripe-gridfieldextensions	`^5`
clesson-de/silverstripe-gridfield-pro	`^1`

Installation

Then run /dev/build?flush=all.

Data Model

Contact hierarchy

Contact is not declared with PHP's abstract keyword because Silverstripe's ORM requires concrete instantiation for has_one stubs. An Injector mapping in _config/config.yml maps Contact → Person as a fallback.

The CMS uses GridFieldAddNewMultiClass to offer Company, Person, and Employee as creation options.

Shared fields (on `Contact`)

Field	Type	Description
`Name`	`Varchar(255)`	Computed display name
`SortingName`	`Varchar(255)`	Computed sorting key
`Slug`	`Varchar(100)`	URL-safe unique slug
`Initials`	`Varchar(10)`	Computed initials
`Note`	`Text`	Free-text note
`CustomerNumber`	`Varchar(50)`	Auto-generated customer number
`CustomerSince`	`Date`	Date when customer number was assigned

Relations (on `Contact`)

Relation	Type	Target
`Account`	`has_one`	`Member`
`Avatar`	`has_one`	`Image`
`Address`	`has_one`	`Address`
`Tags`	`many_many`	`ContactTag`

Extensions registered by this module

Extension	Applied to	Adds
`ContactPaymentAccountsExtension`	`Contact`	`has_many PaymentAccounts`
`PaymentAccountContactExtension`	`PaymentAccount`	`has_one Contact`
`ContactableMember`	`Member`	Reverse link to `Contact`
`SiteConfigOwner`	`SiteConfig`	`has_one SiteOwner → Contact`

Configuration

Website owner

The module adds a dropdown to your SiteConfig for selecting a contact as the website owner. The selected contact is available as a global template variable:

Or via PHP:

Customer number template

The customer number template is configured in Settings → Contacts. The default is K-{Y}-{N:3}.

Available placeholders:

Placeholder	Description	Example
`{Y}`	Year (4-digit)	`2026`
`{y}`	Year (2-digit)	`26`
`{m}`	Month	`04`
`{d}`	Day	`23`
`{H}`	Hour	`14`
`{i}`	Minute	`07`
`{s}`	Second	`52`
`{N:3}`	Random digits (length 3)	`047`
`{A:2}`	Random uppercase letters (length 2)	`KX`
`{X:4}`	Random uppercase letters + digits (length 4)	`A3K9`

Customer numbers are only auto-generated for contacts that belong to the CUSTOMER tag group and do not yet have a customer number.

Contact tags

Define tags that are created automatically on /dev/build:

Address types

Address types are managed by the clesson-de/silverstripe-geocoding module. Configure default types in your project's _config/config.yml:

Developer Documentation

Query helpers

Working with contact types

vCard download

The module exposes a public route for vCard downloads:

Requires the DOWNLOAD_CONTACTS permission. The Contact model provides a getvCardLink() method and a CMS action button.

CMS structure

The Contacts CMS section is a SingleRecordAdmin backed by the ContactConfig singleton. It renders three top-level tabs:

Tab	Content
Contacts	Full list of all `Contact` records (Company, Person, Employee)
Addresses	Full list of all `Address` records
Administration	Inner tabs for `ContactTag` and `AddressType` records

CMS extension hooks

The contact detail form can be extended via Silverstripe extension hooks:

Hook	Description
`updateMainTabSet(TabSet $tabSet)`	Add or modify main tabs
`updateMarginalCMSFields(FieldList $fields)`	Add fields to the sidebar
`updateFixedMarginalCMSFields(FieldList $fields)`	Add fields to the fixed sidebar area
`updateSlug(string &$slug)`	Modify the auto-generated slug before it is saved

Permissions

Permission	Description
`USE_CONTACTS`	View, create, edit, and delete contacts
`DOWNLOAD_CONTACTS`	Download contacts as vCard files

Frontend Assets

The module ships with compiled admin CSS and JavaScript in client/admin/dist/.
If you want to modify the styles, you need to recompile them.

The source files are in client/admin/src/.

Prerequisites

The required Node.js version is specified in .nvmrc (currently Node 22).
If you use nvm, switch to the correct version with:

Install dependencies

Build

Script	Input	Output
`build:js`	`client/admin/src/index.js`	`client/admin/dist/bundle.js`
`build:css`	`client/admin/src/scss/ss-contacts.scss`	`client/admin/dist/bundle.css`

Watch mode (during development)

Note: The output filenames bundle.js and bundle.css are static and must not be renamed — they are referenced by name in PHP.

All versions of silverstripe-contacts with dependencies

PHP Build Version

Package Version

Version 1.1.6 Release 04. Jun 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of silverstripe-contacts from vendor clesson-de

Requires silverstripe/framework Version ^6
clesson-de/silverstripe-geocoding Version ^1
clesson-de/silverstripe-payment-accounts Version ^1
jeroendesloovere/vcard Version ^1.7
giggsey/libphonenumber-for-php Version ^8.13
lekoala/silverstripe-cms-actions Version ^2
symbiote/silverstripe-gridfieldextensions Version ^5
clesson-de/silverstripe-gridfield-pro Version ^2
clesson-de/silverstripe-autocomplete Version ^1

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package clesson-de/silverstripe-contacts contains the following files

Loading the files please wait ...