The Join module provides an action button that has the same functionality as the "Join this site" action on the top toolbar shown on free sites. When a user clicks the button, the Join module first ensures that the user has an account (and asks anonymous users to create an account) and then attempts to make the user a member of the site.
The Join module has these arguments:
- button="text string" — specifies the text for the button, which is "Join this site" by default.
- class="css-class" — specifies CSS class for the div element containing the button, allowing custom styling
The precise behavior of the Join module depends on the access policy of the site:
- On open sites, the user becomes a member instantly.
- On closed and private sites, the user must provide a password or apply to join the site, depending on the access policy configuration.
Note that if the user is already a member, or if the site is by invitation only, the module does not show anything.
Here is the simplest example of use:
[[module Join]]
Here is an example that specifies the button text:
[[module Join button="Join this site, it is cool!"]]
Join button with custom styling:
[[module Join class="my-join-button"]]
If you use custom styling, remember to define the class in your custom CSS. The default class for the join box is ".join-box" and you can style this using custom CSS like this:
.join-box { background-image: url(yourimage.png) }
