Skip to main content

How to Add a Video Conferencing Activity to Moodle with Plug-N-Meet

Welcome to the definitive guide for integrating plugNmeet, a powerful, open-source Moodle video conferencing platform, into your Moodle courses. This document provides a comprehensive walkthrough, from initial setup to leveraging advanced features, ensuring you can build a seamless and engaging virtual classroom experience. With this free video conference software, you can host live online classes, webinars, and meetings without ever leaving your Moodle site.

1. Introduction: Why plugNmeet is the Best Choice for Moodle​

plugNmeet is not just another video meeting tool; it's a complete virtual classroom solution built for deep integration with Moodle.

  • Seamless Native Experience: The classroom loads directly within your Moodle layout. To your students and teachers, it feels like a natural part of your site, not a third-party tool. This boosts user adoption and reduces confusion.
  • Open Source and Free: As a leading open source video conferencing solution, plugNmeet gives you complete ownership. You control your data, your infrastructure, and your costs.
  • Deep Moodle Integration: plugNmeet hooks directly into Moodle's core systems, including the calendar, activity completion, grading, and user permissions, for a truly integrated experience.
  • Rich Feature Set: It's packed with tools designed for education, including an interactive whiteboard, breakout rooms, live polling, and advanced analytics.
  • Unmatched Customization: Brand the entire virtual classroom—from logos and colors to the layout itself—to perfectly match your institution's identity.

2. Installation and Configuration​

To get started with plugNmeet, your Moodle administrator must install the plugin and connect it to a plugNmeet server. This section covers the installation and configuration of the Moodle plugin itself.

Step 2.1: Install the plugNmeet Moodle Plugin​

  1. Download the latest version of the plugin from the Moodle Plugin Directory or the official GitHub repository.
  2. Log in to your Moodle site as an administrator.
  3. Navigate to Site administration > Plugins > Install plugins.
  4. Upload the plugin's ZIP file and click "Install plugin from the ZIP file".
  5. Moodle will check the plugin and prompt you to "Upgrade Moodle database now". Proceed with the upgrade.

Step 2.2: Configure the Plugin Connection​

This is the most critical step. You need to tell Moodle how to connect to your plugNmeet server. Your server administrator will provide you with the necessary credentials.

  1. After installation, you will be taken to the settings page. You can also find it later at Site administration > Plugins > plugNmeet.
  2. API Configuration:
    • Server URL: Enter the full URL of your plugNmeet server (e.g., https://pnm.yourdomain.com).
    • API Key: Enter the PLUGNMEET_API_KEY provided by your server administrator.
    • API Secret: Enter the PLUGNMEET_SECRET provided by your server administrator.
  3. Client Loading Method:
    • Choose Remote (Embedded). This is the recommended setting for a seamless, white-label experience where the classroom loads inside your Moodle page.
    • Redirect is a fallback that sends users to the plugNmeet server's default interface, which is not ideal for branding.
  4. Save changes. The plugin will attempt to connect to the server. If successful, you're ready to go! If not, double-check your credentials and server URL.

Screenshot of the Moodle admin settings page with fields for API credentials and the client loading method highlighted.

3. Creating and Managing a Live Session​

Adding a video conference to a course is simple.

  1. Navigate to the Moodle course where you want to add the session.
  2. Turn Edit mode on.
  3. In the desired section, click Add an activity or resource.
  4. Select plugNmeet from the activity chooser. You will be taken to the activity settings page.

add plugnmeet activity

Detailed Configuration Options​

This form gives you granular control over every aspect of the session.

  • General Settings:

    • Room Title: The name of your session (e.g., "Weekly Biology Seminar"). This is what students will see.
    • Welcome Message: A custom message that appears in the chat when users join. Great for posting an agenda or instructions.
    • Max Participants: Limit the number of users who can join the session.

  • Room Features (Collapsible Section):

    • Moderator must join first: Prevents students from starting the session without a teacher present.
    • Mute on start: A great classroom management tool to ensure a quiet start to the session.
    • Allow Screen Share / Webcams: Enable or disable these core features. You can even set it to "Admin only webcams" for a presentation-style webinar.
    • Allow Breakout Rooms / Max Breakout Rooms: Lets moderators split the session into smaller groups. Set the maximum number of rooms you may need.
    • Pre-assign breakout rooms from course groups: When enabled, each Moodle course group becomes a breakout room automatically — the room title is the group name and members are pre-assigned. Requires plugNmeet server v2.5.0+ and Moodle plugin v3.0.13+. Takes effect from the next session start; the moderator can still rearrange rooms live.
    • Allow Polls: Enables live polls and quizzes in the session. Required if you want to push polls from Moodle quiz questions during a live class (see below).

  • Recording Features:

    • Allow Recording: Master switch to enable/disable all recording types.
    • Allow Cloud Recording: Enables recording directly to the server. This is the most common and useful option.
    • Enable Auto Start Cloud Recording: The session will automatically start recording as soon as the first person joins.

  • Default Lock Settings:

    • These settings establish the initial state of the room locks for participants (not moderators).
    • For a secure-by-default classroom, you can Lock Screen Sharing, Lock Whiteboard, and Lock Shared Notepad. Participants will have to ask for permission (raise their hand) to use these tools.

  • Availability:

    • Available from: Sets the start time for the session. This automatically creates an event in the Moodle Calendar, making it a crucial tool for scheduling your Moodle webinar or class.
    • Deadline: Sets the end time. After this time, the "Join" button will disappear.

4. In-Room Features for Engaging Online Classes​

plugNmeet is packed with tools to foster interaction and collaboration.

  • Interactive Whiteboard: A powerful tool for real-time collaboration. You can draw, write text, upload and annotate PDFs/presentations, and work together with students.
  • Screen Sharing: Share your entire screen, a single application window, or a browser tab with high-quality resolution.
  • Breakout Rooms: Split your main session into smaller, private groups for focused discussions or project work. Moderators can move between rooms and broadcast messages to all. With Moodle course groups, rooms can be pre-assigned automatically (see below).
  • Polls: Create polls on the fly to engage students, check for understanding, or vote on topics. Results can be published live. Teachers can also push a poll straight from a Moodle quiz or question bank question into the live room (see below).
  • Shared Notepad: A simple, real-time collaborative text editor for taking shared notes.
  • AI-Powered Features: If enabled on the server, you can access:
    • Live Transcription & Translation: Get a real-time transcript of the conversation, which can be translated by users into their preferred language.
    • AI Meeting Summarization: Automatically generate and download a summary of the meeting's key points.

5. Advanced Analytics, Attendance, and Completion Tracking​

plugNmeet's integration with Moodle provides unparalleled insights into student engagement.

Cumulative Attendance Reporting​

Unlike tools that only report on a single session, plugNmeet aggregates data across all sessions within a single Moodle activity.

  • For Teachers: Access the Attendance report from the activity page to see a summary of each student's total participation. This includes total time attended, whether they raised their hand, sent chat messages, etc.
  • For Students: Students have their own self-service dashboard where they can see their attendance status and track their own engagement against the activity's requirements.

Screenshot of the teacher's attendance report, showing a list of students with their status and participation metrics. Screenshot of the students's attendance report, showing their participation metrics.

Advanced Activity Completion​

This is one of the most powerful features for Moodle virtual classrooms. You can set highly specific, automated completion rules based on active participation.

  1. In the activity settings, go to the Activity completion section.
  2. Set Completion tracking to "Show activity as complete when conditions are met".
  3. Check the boxes for the criteria you want to enforce. Examples:
    • Require students to attend for a cumulative total of 45 minutes.
    • Require students to send at least one chat message.
    • Require students to enable their webcam at least once.

This system moves beyond passive viewing and encourages active, measurable engagement.

Screenshot of the activity completion settings, with custom plugNmeet rules like "completionminutes" and "completionchatmessages" checked.

6. Real-Time Session Monitoring and Interaction​

In-Activity Live Dashboard​

Once a session is live, teachers and moderators gain access to a real-time dashboard directly on the Moodle activity page. This powerful tool provides an at-a-glance overview of the session's status and allows for direct interaction. You can instantly see:

  • Live Participant List: A list of all users currently in the session.
  • Activity Status: See who has their webcam or microphone active.
  • Session Summary: A summary of key metrics, including participant count, recording status, and active media.

This live data allows moderators to manage the classroom effectively without having to constantly switch between windows.

Screenshot of the Active live sessions with participant details.

Upload to Whiteboard from Moodle​

While a session is running, administrators and teachers can upload files directly to the whiteboard from Moodle's file repository. This feature streamlines the process of sharing course materials without leaving the virtual classroom.

  1. From the live dashboard on the Moodle activity page, click the new "Upload to Whiteboard" button.
  2. This will open the familiar Moodle file picker.
  3. You can select an existing file from your course files.
  4. Once selected, the file is automatically added to the whiteboard's file list inside the live session, ready for you to present to the class.

Screenshot of the Moodle file picker being used to upload a file to the whiteboard.

Add Poll from Quiz / Question Bank (Live)​

While a session is running, teachers can push a poll into the live room straight from a Moodle quiz or question bank question — powered by the Create Poll API. Requires plugNmeet server v2.5.0+ and Moodle plugin v3.0.13+.

  1. From the live dashboard on the Moodle activity page, click "Add Poll from Quiz" (visible only while the room is active).
  2. Choose the source: a course Quiz or the Question Bank category.
  3. Pick a supported question (single-answer multiple choice or true/false).
  4. Choose the mode: Quiz (correct answer revealed after the poll ends) or Vote (responses only), plus Anonymous voting and Auto-close after (minutes, max 60).
  5. Submit — the poll appears in the live room immediately and participants can vote right away. The moderator manages it like any other poll (close, publish results, reopen).

Poll voting also feeds Moodle completion: enable Voted in Poll in the activity completion settings to require participation.

Pre-Assigned Breakout Rooms from Course Groups​

Instead of sorting students manually, let Moodle groups do the work. Requires plugNmeet server v2.5.0+ and Moodle plugin v3.0.13+.

  1. In the activity settings, under Room Features, enable Pre-assign breakout rooms from course groups.
  2. Make sure the course has groups with members (e.g. Site administration or course Participants > Groups).
  3. From the next session start, each group becomes a breakout room: the room title is the group name and members are automatically assigned. Users with no group stay unassigned for the moderator to place live.
  4. The moderator can still rearrange, remove, broadcast, extend, or end rooms from the in-meeting breakout management panel.

Note: room details are fixed at session start, so group changes apply to the next session, not the running one.

Site-Wide Active Session Report (Admin Data Pull)​

For administrators, plugNmeet offers a real-time "live data pull" of all active sessions across the entire Moodle site. This is an essential tool for monitoring site-wide activity.

  • How to Access: An administrator can add a custom link to their admin dashboard or simply navigate to https://youmoodlesite.com/mod/plugnmeet/index.php.
  • What it Shows: The report displays a list of all currently running rooms, showing the room title, course, number of participants, and session duration. This allows admins to see at a glance how the Moodle video conferencing system is being used.

Screenshot of the Active Rooms Report, showing a table of live sessions with participant counts.

7. Managing Post-Session Recordings and Artifacts​

All files generated during your sessions are neatly organized and accessible directly from the Moodle activity page.

Recordings Tab​

Here you can find all cloud recordings. Teachers can:

  • Play the recording.
  • Control visibility (show/hide from students).
  • Download the recording file.
  • Delete the recording.

Screenshot of the Active Recordings.

Merge Multiple Recordings​

If a session was recorded in multiple segments, you can now easily merge them into a single, continuous video directly from the Moodle interface.

  1. Navigate to the Recordings tab for the plugNmeet activity.
  2. You will see checkboxes next to each recording. Select the recordings in the specific order you want them to appear in the final video.
  3. Click the "Merge Recordings" button that appears at the bottom of the list.
  4. A confirmation pop-up will show the list of recording IDs you are about to merge, verifying the sequence of your selection.
  5. Confirm the action to start the merge process. The new, merged recording will appear in the list once it's ready.

Screenshot of the Moodle recordings list with checkboxes and a merge button, showing the merge confirmation pop-up.

Artifacts Tab​

This tab contains all other session-generated files, governed by Moodle permissions. This includes:

  • AI-generated meeting summaries.
  • Transcription files (e.g., VTT, SRT).
  • Detailed per-session analytics reports in JSON format.

Screenshot of the Artifacts.

Screenshot of the Analytics.

8. Security and Privacy​

plugNmeet is designed with security in mind for educational institutions.

  • Role-Based Permissions: The plugin respects Moodle's roles. For example, only users with the mod/plugnmeet:viewrecordings capability can see the recordings tab. The Active Rooms Report is also protected by a specific capability (mod/plugnmeet:viewactiveroomsreport).
  • Secure by Default: Use the Default Lock Settings in your activity to create a controlled environment where students must request permission to share their screen or whiteboard.
  • End-to-End Encryption (E2EE): For maximum security, you can enable E2EE for your sessions.
  • Guest Access Control: Guest access can be disabled globally from the admin settings, and each session's guest link has a configurable expiration time.

This concludes the detailed guide to the plugNmeet Moodle plugin. You are now ready to build a secure, engaging, and fully-branded Moodle video conferencing experience for your users.