Stackoverflow 

Please use https://stackoverflow.com to get best support. Tags you should use are typo3 and tx-easy-verein, so your question will be visible at https://stackoverflow.com/questions/tagged/tx-easy-verein.

Slack 

You can use Slack to get support from other people and help about your questions!

The url is: https://typo3.slack.com/

Sponsoring 

If you need a feature which is not yet implemented, feel free to contact me anytime!

You can find my contact data on https://ephra.im/en/contact.

Private/Personal support 

If you need private or personal support, ask one of the developers for it.

Be aware that this support might not be free!

Latest version from git 

You can get the latest version from git by using the git command:

git clone https://github.com/Kephson/easy_verein.git

Versioning 

EXT:easy_verein uses a 3-number versioning scheme: <major>.<minor>.<patch>

• Major: Major breaking changes
• Minor: Minor breaking changes
• Patch: No breaking changes

Before an update 

Before you start the update procedure, please read the changelog of all versions which have been released in the meantime! You can find those in the manual here.

Furthermore it is always a good idea to do updates on a dedicated test installation or at least create a database backup.

Tab: Easyverein 

• Set the API token; it is needed to connect with your easyVerein instance
• Optional: set a specific API url if not the default one should be used (default: https://easyverein.com/api/stable)
• Optional: set the default request limit of queries against the API (default: 100)
• Optional: configure allowed fields in easyVerein member model (default: joinDate,membershipNumber)
• Optional: allowed fields in easyVerein contact model (default: bankAccountOwner,bic,iban,methodOfPayment,methodOfPaymentName,sepaDate,street,zip,city,country,salutation,name,familyName,firstName,mobilePhone,privateEmail,privatePhone)

With default settings it is only needed to set the API token here.

Tab: Typo3 

• Set the default groupd id of your frontend users (members) here (default user group)
• Set the default storage pid of your frontend users (where to store the users)
• Set page uid of password forget page; it is used in the welcome email to the users
• Enable or disable sending of welcome email after user import

All these settings should be done.

|img-extension-configuration-tab-2|

Tab: Welcomemail 

• Set specific mail settings for the welcome email which will be sent to the users after import
• Set the sender email address and name
• Set a specific mail subject

All these settings should be done if the default should be overwritten.

|img-extension-configuration-tab-3|

Configure easyVerein group shortcodes 

To have the easyVerein groups synchronized with your TYPO3 frontend user groups, please set the easyVerein group code into the field in your TYPO3 user group.

|img-configure-easyverein-groupcode|

Do an initial synchronization of members 

Synchronize your easyVerein members to TYPO3 in a first step to have them in your TYPO3 database. Go to TYPO3 scheduler and configure a new "execute console commands" jobs and select as command easyverein:syncfeuser with the options --initial=1 --syncAll=1. You can also execute this command directly on command line with typo3 easyverein:syncfeuser --initial=1 --syncAll=1.

|img-scheduler-initial-sync|

Manually send a welcome email 

If you want to send a welcome email manually to a member, you can do this in his user profile with selecting the option "Send welcome mail to user" and save the record. After saving the "Last welcome mail sent" field will be updated and the member will get an email.

|img-manually-send-welcome-email|

Update scheduler task to synchronize data periodically 

After initial synchronization update your scheduler task to synchronize the data periodically with easyVerein. Just update the option --initial=0 to do a regular synchronization. Choose a repeating timeslot to execute this job, e.g. once a day (84000 seconds). You can also execute this command directly on command line with typo3 easyverein:syncfeuser --initial=0 --syncAll=1

|img-scheduler-recurring-sync|

Contribution workflow 

Please create always an issue at https://github.com/Kephson/easy_verein/issues before starting with a change. This is essential helpful if you are unsure if your change will be accepted.

List of versions 

Important changes 

All Changes 

This is a list of all changes in this release:

• added welcome email to enable sendout of email if new user was created
• updated synchronizing of members and optimized number of requests against easyVerein
• updated synchronizing of members and changed order to sync newest members first
• updated synchronizing task
• checked jobs and fixed scheduler task

Important changes 

All Changes 

This is a list of all changes in this release:

• added timestamp update in DB after welcome email was sent
• composer update

Important changes 

All Changes 

This is a list of all changes in this release:

• Changed PHP version requirement to ^8.0 Latest

Important changes 

All Changes 

This is a list of all changes in this release:

• fixed sending welcome email when executing easyVerein sync in CLI context
• generated frontend links with Site object instead of Extbase URIBuilder

Important changes 

All Changes 

This is a list of all changes in this release:

• fixed merging old and new groups with fe groups in TYPO3

Important changes 

All Changes 

This is a list of all changes in this release:

• initial release for TYPO3 13.4
• added possibility to work with latest easyVerein API
• automatic refreshing of token

Nothing reported at the moment 

There are no known issues or problems at the moment.

Headline 2 

API 

How to use the API...

$stuff = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(
	'\\Foo\\Bar\\Utility\\Stuff'
);
$stuff->do();

or some other language:

$(document).ready(
	function () {
		doStuff();
	}
);

Tables