silverware/contact

SilverWare Contact Module.

1.5.0 2018-06-12 13:21 UTC

Requires

• php: >=5.6.0
• silverware/countries: ^1.0
• silverware/font-icons: ^1.0
• silverware/silverware: ^1.3
• silverware/validator: ^1.0

BSD-3-Clause

• Colin Tucker

• contact
• silverstripe
• silverware

README

Provides a contact page and contact component for use with SilverWare.

Contents

• Requirements
• Installation
• Usage
• Issues
• Contribution
• Maintainers
• License

Requirements

• SilverWare
• SilverWare Countries
• SilverWare Font Icons
• SilverWare Validator

Installation

Installation is via Composer:

$ composer require silverware/contact

Usage

Contact Page

This module adds a new page type called ContactPage to the application. The contact page displays a form which allows a user to send a message to one or more recipients.

Add recipients on the "Recipients" tab. Each recipient has a:

• name (shown when the user selects a recipient)
• send to name and email address
• send from name and email address
• email subject

By default, the contact page will notify all recipients via email when someone sends a message. To change this behaviour, you can check the "Show recipient field" on the "Options" tab. A dropdown is then shown on the form allowing the user to select a recipient for the message.

Also on the "Options" tab, you can choose whether to show phone and subject fields on the form, and whether the phone field is required. If you uncheck the option "Send via email", the form will record received messages on the "Messages" tab, but will no longer notify recipients via email.

Contact Component

This module also provides a component called ContactComponent, which can be added to your SilverWare templates and layouts. A ContactComponent shows a list of contact-related items, such as addresses, phone numbers, emails and so forth.

The following items are provided with the component:

• AddressItem
• EmailItem
• FaxItem
• HeadingItem
• LinkItem
• LinksItem
• PhoneItem
• SkypeItem
• TextItem

Simply add the ContactComponent where desired in your template or layout, and then add your items as children via the site tree. The item titles will also show font icons if the option "Show icons" is checked on the "Options" tab of ContactComponent.

Issues

Please use the GitHub issue tracker for bug reports and feature requests.

Contribution

Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.

Maintainers

License

BSD-3-Clause © Praxis Interactive