feat(notifications): add leave, kick and ban notifications with actor pills

Extend the notification system to include member leave, kick and ban events,
mirroring the existing join notification functionality.

### Changes
- Added `_handle_leave_notifications` to process LEAVE, KICK and BAN events
- Integrated new notifications into existing membership event handlers
- Introduced `{actor}` placeholder with Matrix URI pill support
- Added `{actor_display}` as plaintext fallback
- Extended template renderer to support actor context
- Ensured consistent rendering across plaintext and HTML messages
- Added template cleanup for cases without an actor (e.g. voluntary leave)

### Templates
New placeholders:
- `{actor}` → clickable Matrix user pill
- `{actor_display}` → plain display name

### Configuration
New config keys:
- `leave_notification_message`
- `kick_notification_message`
- `ban_notification_message`

### Notes
- Fully async and non-blocking implementation
- Backwards compatible with existing templates
- No impact on join notification logic
- Scoped to rooms within configured space

README.md

@@ -4,7 +4,27 @@
   </a>
 </p>
 
-# Advanced Community Bot
+<h1 align="center">
+Advanced Community Bot
+</span>
+<h4 align="center">
+<span style="display:inline-flex; align-items:center; gap:12px;">
+Advanced Community Bot is a Maubot Bot Plugin to manage Matrix servers.
+</span>
+<p>
+
+<h6 align="center">
+  <a href="https://ztfr.eu">🏰 Website</a>
+  ·
+  <a href="https://ztfr.eu/matrix">📰 Zeitfresser Matrix Community</a>
+  ·
+  <a href="https://social.ztfr.eu/@dome">🐘 Mastodon</a> 
+  ·
+  <a href="https://look.ztfr.eu/#/#support:ztfr.eu">💬 Supportchat</a> 
+</h6>
+<br>
+
+## ✨ Introduction
 
 Advanced Community Bot is a powerful Maubot plugin designed to help you manage Matrix communities that are structured around Spaces. It combines moderation tools, automation, and community-driven workflows into a single, opinionated solution that focuses on simplicity, reliability, and clean integration with modern Matrix clients.
 
@@ -12,8 +32,6 @@ The plugin is particularly well suited for communities that want strong control
 
 It was originally created as Community Bot by <a href="https://github.com/williamkray/maubot-communitybot">William Kray</a>. This fork uses his bases and adds additional features and refinments to the bot.
 
----
-
 ## 🛠 What this bot is for
 
 Advanced Community Bot is not meant to replace large-scale moderation frameworks like Draupnir or Mjolnir. Instead, it focuses on providing a cohesive set of tools for managing structured communities with minimal overhead.
@@ -154,6 +172,10 @@ Install the plugin like any other Maubot plugin:
 
 Make sure the bot has sufficient permissions in your rooms (especially for kicking, banning, and redacting messages), otherwise some features will not function correctly.
 
+## 🛠 Development & Support
+
+If you need to get support or want to participate in the active development of this software, you can <a href="https://ztfr.eu/matrix">join our Zeitfresser Matrix Community</a> or the <a href="https://look.ztfr.eu/#/#support:ztfr.eu">Development & Support Channel</a> on Matrix.
+
 ## 🧭 Final Notes
 
 Advanced Community Bot aims to strike a balance between usability and control. It provides the tools needed to manage a structured Matrix community effectively, without overwhelming administrators with complexity.

base-config.yaml

@@ -91,7 +91,7 @@ welcome_sleep: 0
 # (optional)
 notification_room: 
 
-# message to send to the notification room when someone joins one of the above rooms:
+# message to send to the notification room when someone joins or leave one of the above rooms:
 # available placeholders:
 # - {user}: display name of the joining user (falls back to localpart or user ID)
 # - {user_id}: full Matrix user ID
@@ -101,6 +101,15 @@ notification_room:
 # - {room_id}: raw room ID
 join_notification_message: |
   {user} has joined {room}.
+  
+leave_notification_message: |
+  {user} has left {room}.
+  
+kick_notification_message: |
+  {user} was kicked by {actor} from {room}.
+  
+ban_notification_message: |
+  {user} was baned by {actor} from {room}.
 
 # whether to censor files/messages
 # can be boolean (true/false) for all-or-nothing behavior,

community/bot.py

@@ -206,6 +206,8 @@ class CommunityBot(Plugin):
         target_room_id: RoomID,
         template: str,
         context: RenderContext,
+        actor_id: Optional[str] = None,
+        actor_display: Optional[str] = None,
     ) -> None:
         """Render a template once and send plaintext + HTML variants."""
         plain_text, html_message = self._render_message_template(
@@ -214,6 +216,8 @@ class CommunityBot(Plugin):
             context.user_display,
             context.room_id,
             context.room_text,
+            actor_id,
+            actor_display,
         )
         await self.client.send_notice(target_room_id, plain_text, html=html_message)
 
@@ -237,6 +241,56 @@ class CommunityBot(Plugin):
                 self.config["join_notification_message"],
                 context,
             )
+            
+    async def _handle_leave_notifications(self, evt: StateEvent, event_type: str) -> None:
+        """Send notifications when a user leaves, is kicked, or banned."""
+
+        # Optional: nur relevante Räume (wie bei join)
+        space_rooms = await self.get_space_roomlist()
+        if evt.room_id not in space_rooms:
+            return
+
+        if not self.config["notification_room"]:
+            return
+
+        user_id = evt.state_key
+        sender = evt.sender
+
+        context = await self._build_render_context(evt.room_id, user_id)
+        
+        # === Actor bestimmen ===
+        actor_id = None
+        actor_display = None
+
+        if sender != user_id:
+            actor_id = sender
+            actor_display = await self._get_user_display_name(evt.room_id, sender)
+
+        # === Event-Typ bestimmen ===
+        if event_type == "leave" and sender == user_id:
+            template = self.config["leave_notification_message"]
+
+        elif event_type == "kick":
+            template = self.config["kick_notification_message"]
+
+        elif event_type == "ban":
+            template = self.config["ban_notification_message"]
+
+        else:
+            return
+            
+        # === Template cleanup wenn kein actor ===
+        if not actor_id:
+            template = template.replace(" von {actor}", "")
+            template = template.replace(" {actor}", "")
+
+        await self._send_rendered_notice(
+            self.config["notification_room"],
+            template,
+            context,
+            actor_id=actor_id,
+            actor_display=actor_display,
+        )
 
     def _is_human_verification_enabled_for_room(self, room_id: RoomID) -> bool:
         configured = self.config["check_if_human"]
@@ -407,6 +461,20 @@ class CommunityBot(Plugin):
         href = self._matrix_uri_user(str(user_id))
 
         return label, f"<a href='{href}'>{escape(label)}</a>"
+        
+    def _format_actor_pill(
+        self,
+        actor_id: Optional[str],
+        actor_display: Optional[str] = None,
+    ) -> Tuple[str, str]:
+        """Return plaintext and HTML variants for the {actor} placeholder."""
+        if not actor_id:
+            return "", ""
+
+        safe_display = actor_display or actor_id
+        href = self._matrix_uri_user(str(actor_id))
+
+        return safe_display, f"<a href='{href}'>{escape(safe_display)}</a>"
 
     def _format_room_pill(
         self,
@@ -434,6 +502,8 @@ class CommunityBot(Plugin):
         user_display: Optional[str] = None,
         room_id: Optional[str] = None,
         room_text: Optional[str] = None,
+        actor_id: Optional[str] = None,
+        actor_display: Optional[str] = None,
     ) -> Tuple[str, str]:
         user_url = self._matrix_to_url(user_id)
         safe_user_display = user_display or user_id
@@ -442,6 +512,7 @@ class CommunityBot(Plugin):
         room_url = self._matrix_to_url(safe_room_id) if safe_room_id else ""
         user_plain, user_html = self._format_user_pill(user_id, safe_user_display)
         room_plain, room_html = self._format_room_pill(safe_room_id, safe_room_text)
+        actor_plain, actor_html = self._format_actor_pill(actor_id, actor_display)
 
         plain_text = template.format(
             user=user_plain,
@@ -450,6 +521,8 @@ class CommunityBot(Plugin):
             room=room_plain,
             room_link=room_url,
             room_id=safe_room_id,
+            actor=actor_plain,
+            actor_display=actor_display or "",
         )
 
         html_message = template.format(
@@ -462,7 +535,9 @@ class CommunityBot(Plugin):
                 if room_url
                 else escape(safe_room_text)
             ),
-            room_id=escape(safe_room_id),
+            room_id=safe_room_id,
+            actor=actor_html,
+            actor_display=escape(actor_display) if actor_display else "",
         )
 
         return plain_text, html_message
@@ -1331,16 +1406,19 @@ class CommunityBot(Plugin):
     async def handle_leave(self, evt: StateEvent) -> None:
         """Handle voluntary leave events."""
         await self.handle_leave_events(evt)
+        await self._handle_leave_notifications(evt, "leave")
 
     @event.on(InternalEventType.KICK)
     async def handle_kick(self, evt: StateEvent) -> None:
         """Handle kick events."""
         await self.handle_leave_events(evt)
+        await self._handle_leave_notifications(evt, "kick")
 
     @event.on(InternalEventType.BAN)
     async def handle_ban(self, evt: StateEvent) -> None:
         """Handle ban events."""
         await self.handle_leave_events(evt)
+        await self._handle_leave_notifications(evt, "ban")
 
     @event.on(InternalEventType.JOIN)
     async def newjoin(self, evt: StateEvent) -> None:

maubot.yaml

@@ -2,7 +2,7 @@ maubot: 0.1.0
 id: advanced-community-bot
 name: Advanced Community Bot
 description: Advanced Community Bot is a Maubot Bot Plugin to manage Matrix servers. 
-version: 1.0.0
+version: 1.0.1
 license: MIT
 
 modules: