Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Attributes are a way to define custom fields for your club or organisation. Attributes can be for different aspects elements within myClubhouse including Members, Horses, Vehicles, and Subscription Resources. Attributes are divided into different Sets, similar to a Form, to make it easier to control the Entitlements for groups of Attributes, as well as arrange them into logical groups for easier management.

As part of the 6.1 “Kreacher” release, Forms and Attributes have been separated to make them more intuitive and easier to manage as separate entities. Despite this, Attributes still operate in a very similar way to previous versions. Learn more about Forms in this guide: Forms

Table of Contents

Creating a New Attribute Set

  1. Navigate to Forms > Forms Manager.

  2. Select the type of Attribute you want to create:

    1. Member Attributes: Custom fields relating to members/users.

    2. Horse Attributes: Custom fields relating to horses. Equestrian module only.

    3. Vehicle Attributes: Custom fields relating to vehicles. Vehicles module only.

    4. Bookable Asset Attributes: Custom fields relating to bookable assets, such as tennis courts or football pitches. Bookings module only. COMING SOON

    5. Event Attributes: Custom fields for certain types of Events. COMING SOON

    6. Subscription Resource Attributes: Custom fields for certain types of Subscription Resources, e.g. lockers.

  3. Click the green “Create Attribute Set” button.

    CreateAttributeSet.png
  4. Details: Enter the details about the Attributes Set. “Restrict to Member List” in step e will only be shown for Member Attributes.

    Details.png
    1. Name: The name of the Attribute Set.

    2. Description: A short description of the Attribute Set, including the nature of the questions it is asking.

    3. Owner: The owner of the Attribute Set.

    4. Member Access: Select the level of access members can have to their own Attributes in this Set and their answers.

      1. Changeable: Members can enter their own Attributes, view them, and edit them later.

      2. Settable: Members can enter their own answers and view them, but can’t edit them later.

      3. Read-only: Members can view the answers but only admins can enter or edit them.

      4. Hidden: Only admins can view, enter, or edit the answers in this Attribute Set.

    5. Restrict to Member List: If set, Attributes in this Attribute Set will only apply to users in the selected Member List.

    6. Notifications: Select the settings for emails surrounding this Attribute Set.

      1. On form completion: If checked, the Owner (set above) will be sent an email every time a user completes the Attribute Set.

      2. On form edit: If checked, the Owner (set above) will be sent an email every time a user changes an answer to an Attribute in the Attribute Set.

  5. Entitlements: Set the Entitlements for this form. If nothing is changed, the site defaults will be used.

    Entitlements.png
    1. Print Blanks: These users will be able to print a blank copy of the form to be filled out on paper

    2. View All: These users will be able to view all users' answers to this form.

    3. Enter All: These users will be able to enter or change answers to this form on behalf of any user.

    4. Administer: These users will be able to make changes to this form including adding and removing questions.

    5. Analyse: These users will be able to perform analysis on the answers to this form. See more about Analysing Forms in the “Other Functions” section.

  6. Introductory Text: This text will appear at the top of the Form. This can be a short description of the Form or instructions on how to complete it.

    IntroText.png
  7. Add: Click to add a new Attribute.

    AddAttribute.png
  8. Attributes: Set all the attributes for the Set.

    AttributeEditor.png
    1. Name: A short name or title for the Attribute that can be used to identify it easily.

    2. Question/Help Text: The main body of Describe the details required for the Attribute or ask a question.

    3. Type: Select the answer type for the Attribute:

      1. Text: The user can type any text.

        TypeText.png
        1. Sub-Type: Select the sub-type of Text for the Attribute.

          1. Free Text: Any text can be written for the Attribute.

          2. Email Address: The Attribute must be a valid email address.

          3. Phone Number: The Attribute must be a phone number i.e. no lettersalphabetical characters.

          4. URL: The Attribute must be a valid URL, beginning with “http://”, “https://” etc.

          5. Calculated: The Attribute can will be calculated based on another Attributeone or more other Attributes or Form Questions. You can refer to another Attribute by placing its name between two % symbols. To refer to an Attribute in this way, it must come before the current Attribute in the Set, e.g. the third Attribute in a Set can refer to the first or second, but not the fourth.

        2. Single/Multi-line: Select whether the answer box will be either a single-line or a multi-line field. This will normally be dependent answer box, depending on the nature of the answer and the its expected length.

        3. Max. Text Length: If you select “Single Line” is selected above, you can set the maximum number of characters that for the user can useanswer. Note that anything above 255 will automatically change it to “Multi-line”.

      2. Yes/No: The user can select yes or no.

      3. Yes/No/Maybe: The user can select yes, no, or maybe.

        MaybeLabel.png
        1. 'Maybe' Label: If you want the “Maybe” option to be named something else, set it here.

      4. Single Select: The user can select a single option from a pre-defined list.

        1. Edit Options: Click this to add options individually or in bulk.

        2. Allow Other: If set to “Yes”, members will be given an “Other” option at the end of the list so that they can , enabling them to enter an answer that doesn’t appear in the listis not already present.

      5. Multi Select: The user can select multiple options from a pre-defined list.

        1. Edit Options: Click this to add options individually or in bulk.

        2. Allow Other: If set to “Yes”, members will be given an “Other” option at the end of the list so that they can , enabling them to enter an answer that doesn’t appear in the listis not already present.

      6. Integer: A text box into which the user can type any whole number.

        TypeInteger.png
        1. Sub-Type: Select the sub-type of Integer for the answer.

          1. Integer: The Attribute must be a whole number.

          2. Calculated: The Attribute can will be calculated based on another Attributeone or more other Attributes or Form Questions. You can refer to another Attribute by placing its name between two % symbols. To refer to an Attribute in this way, it must come before the current Attribute in the Set, e.g. the third Attribute in a Set can refer to the first or second, but not the fourth.

      7. Date: A calendar from which the user can select a single date.

      8. Currency: A text box into which the user can type any valid monetary amount.

        TypeCurrency.png
        1. Sub-Type: Select the sub-type of Currency for the Attribute.

          1. Currency: The Attribute must be a monetary amount with exactly 2 the exact number of decimal places for the site’s culture currency.

          2. Calculated: The Attribute can will be calculated based on another Attributeone or more other Attributes or Form Questions. You can refer to another Attribute by placing its name between two % symbols. To refer to an Attribute in this way, it must come before the current Attribute in the Set, e.g. the third Attribute in a Set can refer to the first or second, but not the fourth.

        Decimal: A text box into which the user can type any decimal number.

      9. Decimal: A text box into which the user can type any decimal number.

        TypeDecimal.png
        1. Sub-Type: Select the sub-type of Decimal for the Attribute.

          1. Decimal: The Attribute can be any number with any number of decimal places.

          2. Calculated: The Attribute can will be calculated based on another Attributeone or more other Attributes or Form Questions. You can refer to another Attribute by placing its name between two % symbols. To refer to an Attribute in this way, it must come before the current Attribute in the Set, e.g. the third Attribute in a Set can refer to the first or second, but not the fourth.

        Member: An auto
      10. Member: An auto-complete text box from which the user can select a member/user from the site’s database. Note: Anyone filling out this Attribute will have to have require the appropriate Entitlements to look up members. If the public will be filling out this Attribute Set, they won’t will not be able to look up users, regardless of the settings in Entitlements.

      11. Document: The user can upload a document to be submitted as the Attribute.

    4. Mandatory: Set whether this Attribute is optional or must be completed.

    5. Member Access: Select the level of access members have to their own instance of this Attribute and its answer. Note: the Member Access restrictions for the entire Attribute Set will always apply (see 4d), so access can only be locked down further (not increased).

      1. Editable: Members can see and answer this Attribute.

      2. Read-only: Members can read the Attribute but not answer it. Admins can answer it.

      3. Hidden: Only admins can read and answer the Attribute for a member.

    6. Depends on: You can make this a sub-Attribute of another Attribute. This only works for The dependable Attribute must be a Yes/No type Attribute and this Attribute will then appear if the answer to the original question is “Yes”. For example, you could ask “Would you like to play for one of our league teams?”, if the user answers yes, they will then be asked, “When are you usually available for matches?”.

    7. Attribute Code: A unique code to identify the Attribute so it can be used when sending Emails. Click “Re-generate” if you change the Name If you have changed the name of the Attribute, you can click “Re-generate” to update the code.
      (warning) Caution! Regenerating the Attribute Code will break any references saved to Auto-generated Emails, Email Templates, or Partial Email Blocks.
      This is only shown for Member Attributes.

    8. Show to Members: If set to “Yes”, current members will be able to see this Attribute for other members in the Member Directory and when looking at a another member’s profile. If set to “No”, the Attribute will only be visible to adminsthose with the “View All” Entitlement on the Attribute Set, as set in step 5 above.

    9. Hide Editor: Click to hide the editor, making the page easier to navigate when looking at all the Attributes in the Set. When the editor is hidden, the following options become available: Show Editor, Copy Attribute, Delete Attribute, and Obsolete.

...

  1. Show Editor: Click to show the main editor to make changes to the Attribute.

  2. Copy Attribute: If you want to create a similar Attribute, click “Copy Attribute” and then edit your new Attribute.

  3. Delete Attribute: Click to delete this Attribute. Note: The Attribute won’t be fully deleted until the Attribute Set has been saved.

  4. Obsolete: If this Attribute is no longer required, but has been answered, you can make it obsolete which means it will still exist but not be shown to users when they fill out the Attribute Set.

  5. Re-order: Click to drag the list of Attributes into the desired order. Click “OK” to save the new order.

    Re-order.png
  6. Save: When you have finished working on the Attribute Set, click this to save the Attribute Set and return to the Attributes page.

    Save.pngImage Removed

    Repeat these steps to make all Attribute Setsthis to save the Attribute Set and return to the Attributes page.

    Save.pngImage Added
  7. Repeat these steps to make all Attribute Sets.

Legacy Non-Attributes

...

When the 6.1 Kreacher version of myClubhouse was released, any Form that had a mixture of questions and Attributes was converted to an Attribute Set. Any of the questions that were not Attributes will be flagged as “Legacy Non-Attributes”. This means that they will not be visible on a member’s profile page or My Forms, so won’t be able to be completed. There are a few ways to deal with these Legacy Non-Attributes:

Convert to Attribute

You can convert the Form question into a User Attribute. To do this:

  1. Navigate to Forms > Set Up Attribute Questions.

  2. Locate the Attribute Set and click “Edit Attribute Set”.

    EditSet.pngImage Added
  3. Locate the question and click “Show Editor”.

    ShowEditor.pngImage Added
  4. Convert to Attribute: Set this to “Yes”.

  5. Attribute Code: A unique code to identify the Attribute so it can be used when sending Emails. If you change the name of the Attribute, the code should update automatically. This is only shown for Member Attributes.

  6. Show to Members: If set to “Yes”, current members will be able to see this Attribute for other members in the Member Directory and when looking at another member’s profile. If set to “No”, the Attribute will only be visible to those with the “View All” Entitlement on the Attribute Set, as set in step 5 above.

  7. Save: Once you are happy with the details, click this to save the Attribute Set and return to the Attributes page.

    Save.pngImage Added

Delete the Question

If the question is not needed anymore, you can delete it and all the answers to it.

  1. Navigate to Forms > Set Up Attribute Questions.

  2. Locate the Attribute Set and click “Edit Attribute Set”.

    EditSet.pngImage Added
  3. Locate the question and click “Delete Attribute”. Note: The Attribute won’t be fully deleted until the Attribute Set has been saved.

    DeleteAttribute.pngImage Added
  4. Save: Once you are happy with the details, click this to save the Attribute Set and return to the Attributes page.

    Save.pngImage Added

Move to a Questionnaire Form

The other option is to move the Form question to a normal Form, instead of an Attribute Set. See the instructions below for how to move individual questions to another Form, specifically step 3d of the Other Functions section.

Other Functions

Next to each Attribute Set, there are a series of functions:

...

  1. Edit Attribute Set: Make changes to this Attribute Set e.g. add new Attributes or change Entitlements.

  2. Delete Attribute Set: Click to delete the Attribute Set. If any of the Attributes have been answered, a warning symbol will be shown next to the option, as in the screenshot above. If it has been answered, ALL answers will be deleted and cannot be reinstated so only do this if you are certain.

  3. Action: Click for further actions/functions.

    1. Amend Answers: Amending Answers allows administrators to edit or set answers for multiple users in an editable table format.

      1. All users are shown in the table, regardless of whether they have completed the form Attribute Set already.

      2. Locate the user for whom you want to change their answers, possibly using the search bar.

      3. Change the answer in place, from the table.

      You can save a view of certain searches/filters to come back to at a later date. Help on views can be found here: Views

    2. Copy: If you want to create a similar Attribute Set, you can click “Copy” to have a starting point when creating your next Attribute Set.

    3. Edit: Make changes to this Attribute Set e.g. add new Attributes or change Entitlements.

    4. Move Questions: Attributes can be moved from one Attribute Set to another.

      1. Complete the wizard:

        MoveQuestion.png
        1. Target Form: Select the Form/Attribute Set to which you are moving the questions.

        2. Questions: Select which questions you are moving. If a question is dependent on another question’s answer or another question is dependent on it, that question must be moved too.

        3. OK: Once happy, click “OK” to move the selected questions to the new Form/Attribute Set.

      2. Repeat the steps to move all Attributesother Attributes to a different Form/Attribute Set.

    5. Delete: Click to delete the Attribute Set. If any of the Attributes have been answered, a warning symbol will be shown next to the option, as in the screenshot above. If it has been answered, ALL answers will be deleted and cannot be reinstated so only do this if you are certain.

    6. Answer Table: The Answer Table allows you to view all Attribute completions in a table format. You can select which Attributes (columns) you want to display, reorganise the columns, sort, filter, and export.

      You can save a view of certain searches/filters to come back to at a later date. Help on Views can be found here: Views

    7. Charts: Charts can be a very easy way to visually see how users have answered Attributes Attribute question in a Set. A Chart will be shown for each Yes/No, Yes/No/Maybe, Single Select, and Multi Select Attribute in the selected Attribute Set.

      You can save a view of certain searches/filters to come back to at a later date. Help on Views can be found here: Views

    8. Queries: You can create Queries to find users who answered Attributes in particular ways. This guide will help you create Form Queries: Form Queries

    9. Print Forms: You can print all the completed versions of an Attribute Set if you want a PDF or hard copy.

      1. If desired, filter the completed Forms using the search bar, and filters.

      2. Right-click on the page and select “Print”.

      3. Follow your browser instructions to print.

...

  1. Member Attributes: You can find these on Member’s Members' profiles and in the Member Directory.

  2. Horse Attributes: You can find these on Horse’s Horses' profiles and in the Horse Directory. Equestrian module only.

  3. Vehicle Attributes: Add these in Vehicle Types, and view on the Vehicle’s profile pages and in Browse Vehicles. Vehicles module only.

  4. Subscription Resource Attributes: Add to a Resource Set, and view on each Resource page.

...

  1. Navigate to Information > Member Directory.

  2. Click on the light blue “Columns” button at the top-right of the directory table.

  3. Select your Attribute, usually near the bottom, sorted by Attribute Set.

  4. The column will be displayed at the right-hand end of the table.

  5. Drag the column heading to reposition to the column.

  6. Click the column heading to sort the column in ascending order, and click again to sort in descending order.

...