DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: WEC Button

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed:2006-03-29T14:05:39
Email:developer@webempoweredchurch.org

EXT: WEC Button

Extension Key: wec_button

Copyright 2006, Foundation For Evangelism: http://ww.evangelize.org

Author: developer@webempoweredchurch.org, <developer@webempoweredchurch.org>

Support Community: http://www.webempoweredchurch.com/community/

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

EXT: WEC Button 1

Introduction 1

What does it do? 1

What is the Web-Empowered Church? 1

Screenshots 1

Users manual 2

Administration 2

Configuration 2

Typoscript Objects 2

Templates 2

Known problems 3

To-Do list 3

Changelog 3

Introduction

What does it do?

The Web-Empowered Church Button Extension is used provides graphical buttons in a variety of shapes and sizes that indicate involvement with the Web-Empowered Church ministry.

What is the Web-Empowered Church?

The Web-Empowered Church (WEC) is a ministry of the Foundation for Evangelism ( :underline:`www.evangelize.org <http://www.evangelize.org/>`_ ). The mission of WEC is to innovatively apply WEB technology to EMPOWER the worldwide CHURCH for ministry.

WEC will help churches around the world expand evangelism, discipleship, and care through the innovative application of Internet technology. WEC web-based tools and training will help make church ministries more efficient and effective, and will extend ministry impact to a world in need of Jesus (See :underline:`www.WebEmpoweredChurch.org/Jesus <http://www.webempoweredchurch.org/Jesus>`_ ). We want to fuel a worldwide movement using the Internet to point the world to Jesus Christ, to grow disciples, and to care for those in need. Our desire is to use the web to empower the Church to become a truly 24 hours per day 7 days per week ministry that is not constrained by walls or distance or time.

If you would like to find out more about WEC or our tools, or support us in any way, please go to our website for users: :underline:`www.webempoweredchurch.com <http://www.webempoweredchurch.com/>`_ and for software/web developers: :underline:`www.webempoweredchurch.org. <http://www.webempoweredchurch.org/>`_

Screenshots

Example Web-Empowered Church Buttons

img-1

img-2

img-3

Users manual

The WEC Button extension can be installed through the typical TYPO3 installation process using the Extension Manager.

Once installed, adding a WEC button to a page is as simple as adding a frontend plugin to the page where you wish for the data to appear. From this plugin, you can select one of the available buttons via a point and click interface.

Administration

No special administration is required for this extension.

Configuration

Typoscript Objects

The WEC Button extension can be configured in several ways. All of the major variables are accessible through Typoscript objects. These object can be set in the Constant Editor or within a the Constants or Setup portion of a Typoscript page template. The name of each typoscript object takes the form of plugin.tx_wecbutton_pi1.templateFile, etc. The table below provides detailed descriptions of each object as well as that object's default value.

templateFile

Name

templateFile

Description

Marker-based template for a button's HTML output.

Default Value

EXT:wec_button/pi1/template.tmpl

url

Name

url

Description

URL that a buton links to.

altText

Name

altText

Description

Text for alt attribute of <img /> tag. Displayed when images are disabled.

Default Value

Church website tools from the Web-Empowered Church web site

titleText

Name

titleText

Description

Text for title attribute of <a /> tag. Displayed when a link is hovered over.

Default Value

Church website tools from the Web-Empowered Church web site

demoMode

Name

demoMode

Description

Turns demo mode on or off. Demo mode displays all available buttons in the frontend.

Default Value

0 (disabled)

Templates

In addition to the Typoscript configuration, the extension supports marker-based templating. The default template, as defined in the Typoscript constant templateFile, is located at pi1/template.tmp and provides the template for drawing a single button. When demo mode is selected, this same template is used repeatedly.

The template itself is very simple, but demonstrates the markers that are available to custom templates.

<!--
=====================================================================================================
###TEMPLATE### begin
=====================================================================================================
-->
<div style="text-align: center;">
    <a href="###URL###"><img src="###IMAGE###" title="###TITLE_TEXT###" alt="###ALT_TEXT###" border="0"/></a>
</div>
<!-- ###TEMPLATE### end -->

A custom template must provide the “###TEMPLATE### begin” and “###TEMPLATE### end” markers. Within those markers, any HTML can be used. The available markers “###URL###”, “###TITLE_TEXT###”, and “###ALT_EXT###” correspond to the Typoscript objects of the same name, while the “###IMAGE###” marker is filled in automatically based on the selected image.

Known problems

- None

To-Do list

- None

Changelog

1.0.1

Version

1.0.1

Changes

Added missing parenthesis in ext_typoscript_constants.txt

((Unknown Property))

Version

Changes

Added Dutch translation.

1.0.0

Version

1.0.0

Changes

Initial release.

img-4 EXT: WEC Button - 3