Easy Team 1.1 is a Joomla package from JoomlaX that helps you show your staff, teachers, doctors, or club members on your website.

Think of it as two tools that work together:

• Component (Easy Team): the place where you store everyone in the database (like a shared address book). Best when you have many people.
• Module (Easy Team): the display box you put on a page. It can show people you type in by hand, or load them from the component.

What you can do

• Add photos, job titles, bios, categories, email, phone, website, and social links
• Choose from 7 layouts: Cards, Grid, List, Compact, Featured, Carousel, Overlay
• Choose from 5 themes: Classic, Soft, Bold, Minimal, Glass
• Let visitors filter by category or department
• Open a full bio in a popup, or send visitors to a member profile page
• Use pagination, infinite scroll, or show everyone at once on the Team Directory page

Who it is for

Schools, companies, clinics, agencies, sports clubs, churches, and any site that needs a team or staff page.

Built for modern Joomla

• Joomla 4, 5, and 6
• PHP 8.1 or later recommended
• Native JavaScript (no jQuery)
• Web Asset Manager CSS and JS

Before you install

• Joomla: 4.x, 5.x, or 6.x
• PHP: 8.1 or newer
• Database: MySQL or MariaDB
• Access: a Super User (or administrator) account so you can install extensions

Helpful but optional

• Member photos ready in Joomla Media Manager (JPG, PNG, or WebP)
• A menu position on your template for the module (for example Main, Sidebar, or Bottom)
• Font Awesome already loaded by your template (most modern templates include it)

Not required

• jQuery
• Extra plugins for the basic team page to work

Step 1: Download

Email: After you buy from the JoomlaX store, you get an email with the download link.

Store: You can also open the Downloads section and use the same email you used when buying.

File name: EasyTeam_UNZIP.zip

Step 2: Unzip on your computer

1. Right-click EasyTeam_UNZIP.zip and choose Extract (or Unzip).
2. Inside you should see:
   • pkg_easy_team_1.1.0.zip (install this one: component + module together)
   • com_easyteam_1.1.0.zip (component only, if you need it alone)
   • mod_easy_team_1.1.0.zip (module only)
   • ReadMe.txt

For a normal new install, always use pkg_easy_team_1.1.0.zip.

Step 3: Install in Joomla

1. Log in to the Joomla administrator.
2. Go to System > Install > Extensions.
3. Click Upload Package File.
4. Choose pkg_easy_team_1.1.0.zip and wait for the success message.
5. Open Components > Easy Team to confirm the Dashboard loads.
6. Clear Joomla cache: System > Maintenance > Clear Cache (or use Clean Cache if your admin bar shows it).

What the package installs

• com_easyteam: admin dashboard, categories, members, configuration, and site Team / Member pages
• mod_easy_team: the site module that displays the team

Updates

Install a newer pkg_easy_team zip the same way. The package uses method="upgrade", so your members and settings stay safe.

Follow these steps in order the first time. You can finish in about 15 to 30 minutes.

1. Open Easy Team

1. In the administrator, click Components > Easy Team.
2. You should see the Dashboard with counts for members and categories.

2. Create categories

1. Click Categories (or open it from the Dashboard card).
2. Click New.
3. Type a title such as Leadership, Teachers, or Support.
4. Set Status to Published.
5. Click Save & Close.
6. Repeat for each group you need.

Categories are folders for people. Visitors can filter by them later.

3. Add members

1. Open Members.
2. Click New.
3. Fill Name (required), Photo, Role, and choose a Category.
4. Add a short Bio if you want.
5. Optional: email, phone, website, and social URLs.
6. Set Status to Published, then Save & Close.

4. Review Configuration

1. Open Configuration.
2. On the Content tab, type an Eyebrow, Headline, and Description for the Team list page (or leave blank for defaults).
3. On the Layout tab, pick a layout and theme you like.
4. Click Save.

5. Create a menu item for the Team page

1. Go to Menus > [Your menu] > New.
2. Title: for example Team or Our Staff.
3. Menu Item Type: choose Easy Team > Team (Team Directory list).
4. Publish the item and Save.

6. (Optional) Add the module on another page

1. Go to Content > Site Modules > New.
2. Select Easy Team.
3. Set Data source to From component.
4. Choose a Position, assign menu pages, Publish, then Save.

7. Check the front end

1. Open your site in a new browser tab.
2. Click the Team menu item.
3. Confirm photos and names appear.
4. If something looks old, clear cache and hard-refresh the page (Ctrl+F5).

Easy Team gives you two ways to put people on a page. Pick the one that matches your size.

Use the component (recommended for most sites)

• You add people once under Components > Easy Team > Members
• You create a menu item of type Easy Team > Team
• Visitors get a full Team Directory page with filters, pagination, and member profile pages
• The module can also load the same people with Data source = From component

Use the module with Manual members

• Best for a small team (about 3 to 12 people) on one page
• You type each person inside the module settings
• No need to use the component database for that module
• Good for a single About page

Simple rule

• Many people, or reuse on several pages: use the component
• One small block on one page: Manual members in the module is fine

Open Components > Easy Team. The Dashboard is your home screen.

What you see

• Quick buttons: Members, Categories, Configuration, Clean Cache
• Count cards: total members, published members, featured members, categories
• Action cards: click Members, Categories, or Configuration to jump straight in

Student tip

If the counts are zero, you have not added data yet. Start with Categories, then Members. Configuration can wait until you have at least one published person.

Categories group people (for example Leadership, Engineering, Design, Support).

Open the list

1. Go to Components > Easy Team > Categories.
2. Use Search to find a title quickly.
3. Click a title to edit, or click New.

When you create or edit a category

• Title: the name visitors see on filter tabs
• Alias: used in URLs; leave blank and Joomla builds one from the title
• Description: optional notes for you
• Published: only published categories appear in filters and member forms
• Ordering: controls the order of filter tabs

Why categories matter

• On the Team Directory page, visitors can click a category filter
• In the module (From component), you can show only selected categories
• Each member can belong to one category

Click New or open an existing category.

1. Type a clear Title (example: Leadership).
2. Leave Alias blank unless you need a custom URL piece.
3. Set Status to Published.
4. Click Save & Close.

Create all your groups before you add many members. That way you can assign each person to the right category on the first save.

Open Components > Easy Team > Members.

List tools

• Search: find someone by name
• Filters: narrow by published state or category when available
• Ordering: drag or set numbers so people appear in the order you want
• Featured: mark VIP people for the Featured layout
• Publish / Unpublish: hide someone without deleting them

Add a person

1. Click New.
2. Complete the profile (next tab in this documentation).
3. Save.

Student tip

Unpublished members do not show on the website. Use Unpublish for people who left, instead of deleting, if you might need their profile later.

This screen is where one person lives. Work top to bottom.

Profile tab

• Name (required): display name, for example Alex Rivera
• Alias: URL piece for the profile page; leave blank to auto-create
• Sort name: optional name used when sorting A to Z (useful if you sort by last name)
• Photo: click Select, pick an image from Media Manager (folder images/easy-team is a good place)
• Role: job title under the name
• Secondary role: optional second title
• Category: pick the group, or Uncategorised
• Bio: longer text for the profile and bio modal
• Skills: optional short list
• Location: optional city or office
• Linked user: optional link to a Joomla user account

Contact tab

• Email, Phone, Website: shown as icons when Show Contact is on

Social tab

• Paste full URLs for LinkedIn, X, Facebook, Instagram, GitHub, YouTube, Dribbble, TikTok
• WhatsApp: phone with country code, for example +15551234567
• Leave unused fields empty so those icons stay hidden

Publishing tab

• Featured: Yes highlights the person in Featured layout
• Status: Published or Unpublished
• Ordering, Access, Language
• Meta keywords / description: optional SEO for the member profile page

Save

Click Save to stay on the form, or Save & Close to return to the list.

Open Components > Easy Team > Configuration. These settings control the Team Directory page and member profiles. Click Save after changes.

The form has tabs across the top. Each tab is explained below in plain language.

Content

• Eyebrow: small label above the main title
• Headline: main title on the Team list (leave blank for the default text)
• Description: short intro under the headline

Layout

• Layout: Cards, Grid, List, Compact, Featured, Carousel, Overlay
• Theme: Classic, Soft, Bold, Minimal, Glass
• Photo shape: Circle, Rounded, or Square
• Photo size: width in pixels (about 80 to 400)
• Columns: 1 to 6 on wide screens
• Gap: space between cards (example: 24px)
• Alignment: Left, Center, Right
• Show role / category / bio / social / contact: turn pieces on or off
• Bio length: how many characters of bio show on the card (0 = full text)
• Show filters: category filter tabs when more than one category exists
• Filter alignment: where the filter tabs sit
• Bio modal: popup with the full profile when member linking is off
• Link members: Yes opens the member profile page when a visitor clicks a card
• Open member in new tab: only when Link members is Yes
• Hover effect / Social on hover: motion and icon reveal options
• Open links in new tab: for social and website icons
• Carousel auto-play / speed: only when Layout is Carousel
• Show demo nav: optional strip of demo menu links (turn Off on a live site)

Appearance

• Accent, name, role, and text colours
• Card background, border colour, border radius, drop shadow
• Extra CSS: optional custom rules for advanced users

List defaults

• List limit: how many members per page (example: 12)
• Pagination mode: Pages (numbered), Scroll (load more while scrolling), or None (show all up to the limit rules)
• Hash filters: Yes updates the browser address when a filter is clicked (example: #leadership) so links can be shared
• Show result count: shows how many people match
• Default ordering: Ordering, Name, or Sort name

Member profile

• Show back link: Yes shows a return link to the Team list on the profile page

Images

• Prefer WebP: modern smaller image format when possible
• WebP quality / max width / max height: resize rules for uploads
• Image folder: default images/easy-team
• Lazy load: loads photos as the visitor scrolls (faster first paint)

JSON-LD

• Optional schema.org Person data for search engines
• Enable only if you understand structured data; leave Off for a simple site

Social networks

• Global switches to enable or disable each network site-wide
• If LinkedIn is Off here, LinkedIn icons will not show even if a member has a URL

This is the public Team list page from the component.

Create the menu item

1. Go to Menus > [Your menu] > Add New Menu Item.
2. Menu Title: Team (or any name).
3. Click Select next to Menu Item Type.
4. Choose Easy Team > Team.
5. Publish, assign access if needed, then Save.

What visitors see

• Optional eyebrow, headline, and description from Configuration
• Category filter tabs (when enabled and you have more than one category)
• Member cards using your chosen layout and theme
• Result count and pagination (pages or infinite scroll)

Click behaviour

• If Link members is Yes, a click opens the member profile page
• If Link members is No and Bio modal is Yes, a click can open a popup bio
• Social icons always open their own URLs

Each published member can have a detail page with photo, role, bio, contact, and social links.

How visitors reach it

• From the Team Directory when Link members is Yes
• From a dedicated menu item of type Easy Team > Member (usually used for demos or a featured person)

Back link

When Show back link is Yes in Configuration, the profile shows a control that returns to the Team list.

Student tip

Always upload a clear photo and write a short bio. A name and role alone look incomplete on a profile page.

Use the module when you want a team block inside a page layout position (header, sidebar, article bottom, and so on).

Create the module

1. Go to Content > Site Modules.
2. Click New.
3. Select Easy Team.
4. Give it a Title (example: Home Team).
5. Choose a Position that exists in your template.
6. On the Menu Assignment tab, choose the pages where it should appear.
7. Set Status to Published.
8. Click Save.

Data source (most important setting)

• Manual members: add people in the Members tab of the module (small teams)
• From component: load published people from Components > Easy Team

When Data source is From component

• Categories: leave empty for all, or pick specific groups
• Featured only: Yes shows only featured members
• Limit: 0 means no extra limit; otherwise max number to load
• Ordering: Ordering, Name, Sort name, or Random

You still use the Layout and Appearance tabs to control how the module looks.

When Data source is Manual members, the Members tab shows a repeatable list.

For each person click Add, then fill:

• Published: hide without deleting
• Photo: from Media Manager
• Name (required)
• Role / Title
• Department: used for filter tabs when people have different departments
• Featured
• Bio
• Email / Phone / Website
• Social URLs and WhatsApp number

Department filters appear only when Show Department Filter is Yes and you have at least two different department values.

Content tab

• Eyebrow, Headline, Description: optional text above the grid. Leave blank if the page article already has a heading.

Layout tab (same ideas as component Configuration)

• Layout: Cards, Grid, List, Compact, Featured, Carousel, Overlay
• Theme: Classic, Soft, Bold, Minimal, Glass
• Photo shape / size, Columns, Gap, Alignment
• Show Role, Department, Bio, Bio Length
• Show Social, Show Contact
• Show Department Filter
• Bio Modal: full profile popup
• Hover Effect, Social on Hover
• Open Links in New Tab
• Carousel Auto-play / Speed (Carousel layout only)
• Person JSON-LD: optional schema markup for this module instance

Student tip

Start with Layout = Cards, Theme = Classic, Columns = 3. Change one setting at a time, Save, then refresh the front end so you can see what each option does.

Appearance

• Accent Color (default #1819ed): filters and highlights
• Name Color, Role Color, Text Color
• Card Background, Border Color, Border Radius, Drop Shadow

If you type an invalid colour, Easy Team falls back to a safe default.

Advanced

• Layout: alternate module chrome layout if your template provides one
• Module Class Suffix: extra CSS class on the module wrapper
• Extra CSS: custom CSS for this module only. Unsafe patterns such as script tags, expression(), javascript:, and @import are stripped.

After the module is published and assigned to a page, visit that page on the front end.

Checklist if you see nothing

1. Is the module Status = Published?
2. Is the Position correct for your template?
3. Is Menu Assignment set to the page you are viewing?
4. If Data source is From component, do you have published members?
5. If Manual members, did you add at least one published person with a Name?
6. Did you clear cache?

Component: member fields

• Name, Alias, Sort name, Photo, Role, Secondary role, Category, Bio, Skills, Location, Linked user
• Email, Phone, Website
• LinkedIn, X, Facebook, Instagram, GitHub, YouTube, Dribbble, TikTok, WhatsApp
• Featured, Published, Ordering, Access, Language, Meta

Component: Configuration tabs

• Content: Eyebrow, Headline, Description
• Layout: layout, theme, photo, columns, filters, modal, linking, carousel
• Appearance: colours, radius, shadow, Extra CSS
• List defaults: limit, pagination mode, hash filters, result count, ordering
• Member profile: back link
• Images: WebP, sizes, folder, lazy load
• JSON-LD options
• Social network enable switches

Module

• Data source, Manual members or From component filters
• Content eyebrow / headline / description
• Layout and Appearance (same family of options as the component)
• Advanced: module layout, class suffix, Extra CSS
• Position, Menu Assignment, Published

• Nothing appears on the Team page

  • Add at least one Published member. Confirm the menu item type is Easy Team > Team. Clear cache.

• Module is missing

  • Check Published, Position, and Menu Assignment. Confirm Data source has people to show.

• Photos are missing

  • Open the member (or module row) and confirm the Photo path in Media Manager. Upload into images/easy-team/ if you like a clean folder.

• Category filters do not show

  • Turn on Show filters (component) or Show Department Filter (module). You need more than one category/department in use.

• Click does nothing useful

  • For profile pages, set Link members to Yes. For a popup bio, set Link members to No and Bio modal to Yes. Social icons open their own sites on purpose.

• Social icons missing

  • Turn on Show Social. Fill URLs. Check Configuration > Social networks switches. Font Awesome must load in your template.

• Carousel does not auto-advance

  • Set Layout to Carousel, enable Auto-play, check Speed. Auto-play respects prefers-reduced-motion.

• Old look after changing settings

  • Save Configuration or the module, clear Joomla cache, then hard-refresh the browser (Ctrl+F5).

• From component shows zero people

  • Confirm com_easyteam is installed and members are Published. If you filtered by category, make sure those categories have members.

• Which Joomla versions are supported?

  • Joomla 4, 5, and 6. PHP 8.1 or later is recommended.

• What file do I install?

  • Unzip EasyTeam_UNZIP.zip, then install pkg_easy_team_1.1.0.zip from System > Install > Extensions.

• Can the module load people from the component?

  • Yes. Set Data source to From component.

• Can I place several team modules on one page?

  • Yes. Each module instance is independent. With From component, several modules can share one member library and show different categories.

• Does it need jQuery?

  • No. Easy Team uses native JavaScript.

• What is Person JSON-LD?

  • Optional structured data for search engines. Leave it Off unless you need it.

• Where can I get help?

  • Visit support.joomlax.com. Include your Joomla version, PHP version, page URL, and a short description of what you expected versus what you saw.