Space Objects : Share options

.changes/2390-space-object-share.md

@@ -0,0 +1,2 @@
+- [New] : Now you can directly share space objects (Pin, Event and TaskList) to new Boost from their detail page.
+- [New] : You can now share any object via its own unique QR code.

app/lib/common/widgets/share/action/share_space_object_action.dart

@@ -0,0 +1,170 @@
+import 'dart:io';
+
+import 'package:acter/common/utils/routes.dart';
+import 'package:acter/common/widgets/share/widgets/attach_options.dart';
+import 'package:acter/common/widgets/share/widgets/external_share_options.dart';
+import 'package:acter/common/widgets/share/widgets/file_share_options.dart';
+import 'package:acter/features/deep_linking/actions/show_qr_code.dart';
+import 'package:acter/features/deep_linking/types.dart';
+import 'package:acter/features/files/actions/download_file.dart';
+import 'package:acter/features/news/model/news_references_model.dart';
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+import 'package:open_filex/open_filex.dart';
+import 'package:share_plus/share_plus.dart';
+
+typedef SpaceObjectDetails = ({
+  String spaceId,
+  ObjectType objectType,
+  String objectId,
+});
+
+typedef FileDetails = ({
+  File file,
+  String? mimeType,
+});
+
+Future<void> openShareSpaceObjectDialog({
+  required BuildContext context,
+  SpaceObjectDetails? spaceObjectDetails,
+  FileDetails? fileDetails,
+}) async {
+  await showModalBottomSheet(
+    showDragHandle: true,
+    useSafeArea: true,
+    context: context,
+    isScrollControlled: true,
+    isDismissible: true,
+    builder: (context) => ShareSpaceObjectActionUI(
+      spaceObjectDetails: spaceObjectDetails,
+      fileDetails: fileDetails,
+    ),
+  );
+}
+
+class ShareSpaceObjectActionUI extends StatelessWidget {
+  final SpaceObjectDetails? spaceObjectDetails;
+  final FileDetails? fileDetails;
+
+  const ShareSpaceObjectActionUI({
+    super.key,
+    this.spaceObjectDetails,
+    this.fileDetails,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return SingleChildScrollView(
+      child: Padding(
+        padding: const EdgeInsets.all(12),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.stretch,
+          mainAxisAlignment: MainAxisAlignment.start,
+          children: [
+            if (spaceObjectDetails != null) ...[
+              attachmentOptionsUI(context, spaceObjectDetails!),
+              SizedBox(height: 16),
+              externalShareOptionsUI(context, spaceObjectDetails!),
+              SizedBox(height: 20),
+            ],
+            if (fileDetails != null) fileShareOptionsUI(context, fileDetails!),
+          ],
+        ),
+      ),
+    );
+  }
+
+  Widget attachmentOptionsUI(
+    BuildContext context,
+    SpaceObjectDetails spaceObjectDetails,
+  ) {
+    String spaceId = spaceObjectDetails.spaceId;
+    ObjectType objectType = spaceObjectDetails.objectType;
+    String objectId = spaceObjectDetails.objectId;
+
+    final newsRefType = getNewsRefTypeFromObjType(objectType);
+    return AttachOptions(
+      onTapBoost: () {
+        Navigator.pop(context);
+        context.pushNamed(
+          Routes.actionAddUpdate.name,
+          queryParameters: {'spaceId': spaceId},
+          extra: newsRefType != null
+              ? NewsReferencesModel(type: newsRefType, id: objectId)
+              : null,
+        );
+      },
+    );
+  }
+
+  Widget externalShareOptionsUI(
+    BuildContext context,
+    SpaceObjectDetails spaceObjectDetails,
+  ) {
+    String spaceId = spaceObjectDetails.spaceId;
+    ObjectType objectType = spaceObjectDetails.objectType;
+    String objectId = spaceObjectDetails.objectId;
+
+    final internalLink =
+        'acter:o/${spaceId.substring(1)}/${objectType.name}/${objectId.substring(1)}';
+
+    return ExternalShareOptions(
+      onTapQr: () {
+        Navigator.pop(context);
+        showQrCode(
+          context,
+          internalLink,
+        );
+      },
+    );
+  }
+
+  Widget fileShareOptionsUI(
+    BuildContext context,
+    FileDetails fileDetails,
+  ) {
+    File file = fileDetails.file;
+    String? mimeType = fileDetails.mimeType;
+    return FileShareOptions(
+      onTapOpen: () async {
+        final result = await OpenFilex.open(file.absolute.path);
+        if (result.type == ResultType.done) {
+          // done, close this dialog
+          if (context.mounted) {
+            Navigator.pop(context);
+          }
+        }
+      },
+      onTapSave: !Platform.isAndroid
+          ? () async {
+              if (await downloadFile(context, file)) {
+                // done, close this dialog
+                if (context.mounted) {
+                  Navigator.pop(context);
+                }
+              }
+            }
+          : null,
+      onTapShare: () async {
+        final result = await Share.shareXFiles(
+          [XFile(file.path, mimeType: mimeType)],
+        );
+        if (result.status == ShareResultStatus.success) {
+          // done, close this dialog
+          if (context.mounted) {
+            Navigator.pop(context);
+          }
+        }
+      },
+    );
+  }
+
+  NewsReferencesType? getNewsRefTypeFromObjType(ObjectType objectType) {
+    return switch (objectType) {
+      ObjectType.pin => NewsReferencesType.pin,
+      ObjectType.calendarEvent => NewsReferencesType.calendarEvent,
+      ObjectType.taskList => NewsReferencesType.taskList,
+      _ => null,
+    };
+  }
+}

app/lib/common/widgets/share/widgets/attach_options.dart

@@ -0,0 +1,124 @@
+import 'package:acter/common/themes/colors/color_scheme.dart';
+import 'package:atlas_icons/atlas_icons.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_gen/gen_l10n/l10n.dart';
+
+class AttachOptions extends StatelessWidget {
+  final String? sectionTitle;
+  final GestureTapCallback? onTapBoost;
+  final GestureTapCallback? onTapPin;
+  final GestureTapCallback? onTapEvent;
+  final GestureTapCallback? onTapTaskList;
+  final GestureTapCallback? onTapTaskItem;
+
+  const AttachOptions({
+    super.key,
+    this.sectionTitle,
+    this.onTapBoost,
+    this.onTapPin,
+    this.onTapEvent,
+    this.onTapTaskList,
+    this.onTapTaskItem,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final lang = L10n.of(context);
+
+    return Column(
+      mainAxisSize: MainAxisSize.min,
+      mainAxisAlignment: MainAxisAlignment.start,
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        if (sectionTitle != null) ...[
+          Row(
+            children: [
+              Divider(indent: 0),
+              Text(
+                sectionTitle!,
+                textAlign: TextAlign.start,
+                style: Theme.of(context).textTheme.labelLarge,
+              ),
+              Expanded(child: Divider(indent: 20)),
+            ],
+          ),
+          SizedBox(height: 12),
+        ],
+        Wrap(
+          children: [
+            if (onTapBoost != null)
+              attachToItemUI(
+                name: lang.newBoost,
+                iconData: Atlas.megaphone_thin,
+                color: boastFeatureColor,
+                onTap: onTapBoost,
+              ),
+            if (onTapPin != null)
+              attachToItemUI(
+                name: lang.pin,
+                iconData: Atlas.pin,
+                color: pinFeatureColor,
+                onTap: onTapPin,
+              ),
+            if (onTapEvent != null)
+              attachToItemUI(
+                name: lang.event,
+                iconData: Atlas.calendar,
+                color: eventFeatureColor,
+                onTap: onTapEvent,
+              ),
+            if (onTapTaskList != null)
+              attachToItemUI(
+                name: lang.taskList,
+                iconData: Atlas.list,
+                color: taskFeatureColor,
+                onTap: onTapTaskList,
+              ),
+            if (onTapTaskItem != null)
+              attachToItemUI(
+                name: lang.task,
+                iconData: Atlas.list,
+                color: taskFeatureColor,
+                onTap: onTapTaskItem,
+              ),
+          ],
+        ),
+      ],
+    );
+  }
+
+  Widget attachToItemUI({
+    required String name,
+    required IconData iconData,
+    required Color color,
+    GestureTapCallback? onTap,
+  }) {
+    return InkWell(
+      borderRadius: BorderRadius.circular(16),
+      onTap: onTap,
+      child: Container(
+        margin: const EdgeInsets.all(10),
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            Container(
+              padding: const EdgeInsets.all(14),
+              decoration: BoxDecoration(
+                color: color.withOpacity(0.3),
+                borderRadius: BorderRadius.circular(16),
+                border: Border.all(
+                  color: color,
+                  style: BorderStyle.solid,
+                  width: 1.0,
+                ),
+              ),
+              child: Icon(iconData),
+            ),
+            SizedBox(height: 6),
+            Text(name, textAlign: TextAlign.center),
+          ],
+        ),
+      ),
+    );
+  }
+}