Skip to content

Commit 998fe33

Browse files
cengiz-pzcengiz-pz
committed
Initial commit.
1 parent 3ec7472 commit 998fe33

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

71 files changed

+4478
-21
lines changed

‎.github/FUNDING.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
custom: https://fund.godotengine.org/
2+
github: cengiz-pz

‎.github/ISSUE_TEMPLATE/bug_report.yaml‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
name: 🐞 Bug
2+
description: File a bug/issue
3+
title: "[BUG] <title>"
4+
labels: ["Bug", "Needs Triage"]
5+
body:
6+
- type: checkboxes
7+
attributes:
8+
label: Is there an existing issue for this?
9+
description: Please search to see if an issue already exists for the bug you encountered.
10+
options:
11+
- label: I have searched the existing issues
12+
required: true
13+
- type: textarea
14+
attributes:
15+
label: Current Behavior
16+
description: A clear and concise description of what the bug is.
17+
validations:
18+
required: true
19+
- type: textarea
20+
attributes:
21+
label: Expected Behavior
22+
description: A concise description of what you expected to happen.
23+
validations:
24+
required: true
25+
- type: textarea
26+
attributes:
27+
label: Steps To Reproduce
28+
description: Steps to reproduce the behavior.
29+
placeholder: |
30+
1. Installed manually | Installed via AssetLib
31+
2. Called method '....'
32+
3. Received signal '....'
33+
4. Noticed ADB Logcat error '...'
34+
validations:
35+
required: false
36+
- type: dropdown
37+
id: godot_version
38+
attributes:
39+
label: Godot Version
40+
description: What version of Godot are you running?
41+
options:
42+
- 4.3.stable
43+
- 4.4.1.stable
44+
- 4.5.stable
45+
- 4.x
46+
- Other
47+
default: 1
48+
validations:
49+
required: true
50+
- type: dropdown
51+
id: godot_os
52+
attributes:
53+
label: OS Godot Is Running On
54+
description: What operating system is Godot running on?
55+
options:
56+
- Windows 11
57+
- Windows (other)
58+
- macOS 15
59+
- macOS (other)
60+
- Android 14
61+
- Android 15
62+
- Android (other)
63+
- Other OS
64+
default: 0
65+
validations:
66+
required: true
67+
- type: dropdown
68+
id: plugin_version
69+
attributes:
70+
label: Plugin Version
71+
description: What version of the plugin are you running?
72+
options:
73+
- "4.0"
74+
- "4.1"
75+
- "5.0"
76+
- Other
77+
default: 4
78+
validations:
79+
required: true
80+
- type: dropdown
81+
id: plugin_os
82+
attributes:
83+
label: OS Plugin Is Running On
84+
description: What operating system the plugin (and your app) is running on?
85+
options:
86+
- Android 13
87+
- Android 14
88+
- Android 15
89+
- Android (other)
90+
- iOS 18.x
91+
- iOS 18.5
92+
- iOS (other)
93+
default: 2
94+
validations:
95+
required: true
96+
- type: textarea
97+
attributes:
98+
label: Anything else?
99+
description: |
100+
Links? References? Anything that will give more context about the issue you are encountering!
101+
102+
Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
103+
validations:
104+
required: false

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# disable blank issue creation
2+
blank_issues_enabled: false

‎.github/ISSUE_TEMPLATE/feature_request.yaml‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
name: 🐠 Feature Request
2+
description: Suggest an idea for this project
3+
title: "[FEATURE REQ] <title>"
4+
labels: ["Enhancement", "Question"]
5+
body:
6+
- type: checkboxes
7+
attributes:
8+
label: Is there an existing issue for this?
9+
description: Please search to see if an issue already exists for the bug you encountered.
10+
options:
11+
- label: I have searched the existing issues
12+
required: true
13+
- type: textarea
14+
attributes:
15+
label: Current Behavior
16+
description: Is your feature request related to a problem? Please describe.
17+
validations:
18+
required: true
19+
- type: textarea
20+
attributes:
21+
label: Proposed Behavior
22+
description: A clear and concise description of what you want to happen.
23+
validations:
24+
required: true
25+
- type: textarea
26+
attributes:
27+
label: Alternative Solutions
28+
description: Describe alternatives you've considered.
29+
placeholder: |
30+
A clear and concise description of any alternative solutions or features you've considered.
31+
validations:
32+
required: false
33+
- type: dropdown
34+
id: godot_version
35+
attributes:
36+
label: Godot Version
37+
description: What version of Godot are you running?
38+
options:
39+
- 4.3.stable
40+
- 4.4.1.stable
41+
- 4.5.stable
42+
- 4.x
43+
- Other
44+
default: 1
45+
validations:
46+
required: true
47+
- type: dropdown
48+
id: godot_os
49+
attributes:
50+
label: OS Godot Is Running On
51+
description: What operating system is Godot running on?
52+
options:
53+
- Windows 11
54+
- Windows (other)
55+
- macOS 15
56+
- macOS (other)
57+
- Android 14
58+
- Android 15
59+
- Android (other)
60+
- Other OS
61+
default: 0
62+
validations:
63+
required: true
64+
- type: dropdown
65+
id: plugin_version
66+
attributes:
67+
label: Plugin Version
68+
description: What version of the plugin are you running?
69+
options:
70+
- "4.0"
71+
- "4.1"
72+
- "5.0"
73+
- Other
74+
default: 4
75+
validations:
76+
required: true
77+
- type: dropdown
78+
id: plugin_os
79+
attributes:
80+
label: OS Plugin Is Running On
81+
description: What operating system the plugin (and your app) is running on?
82+
options:
83+
- Android 13
84+
- Android 14
85+
- Android 15
86+
- Android (other)
87+
- iOS 18.x
88+
- iOS 18.5
89+
- iOS (other)
90+
default: 2
91+
validations:
92+
required: true
93+
- type: textarea
94+
attributes:
95+
label: Anything else?
96+
description: |
97+
Links? References? Anything that will give more context about the issue you are encountering!
98+
99+
Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
100+
validations:
101+
required: false

‎.gitignore‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
#
2+
# © 2024-present https://github.com/cengiz-pz
3+
#
4+
5+
demo/.godot/
6+
demo/addons/
7+
demo/android/
8+
android/.idea/

‎LICENSE‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
MIT License
2-
3-
Copyright (c) 2025 Godot Engine Community SDK Integrations
4-
5-
Permission is hereby granted, free of charge, to any person obtaining a copy
6-
of this software and associated documentation files (the "Software"), to deal
7-
in the Software without restriction, including without limitation the rights
8-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9-
copies of the Software, and to permit persons to whom the Software is
10-
furnished to do so, subject to the following conditions:
11-
12-
The above copyright notice and this permission notice shall be included in all
13-
copies or substantial portions of the Software.
14-
15-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21-
SOFTWARE.
1+
MIT License
2+
3+
Copyright (c) 2025 Godot Engine Community SDK Integrations
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
<p align="center">
2+
<img width="256" height="256" src="demo/assets/share-android.png">
3+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4+
<img width="256" height="256" src="demo/assets/share-ios.png">
5+
</p>
6+
7+
---
8+
9+
# <img src="addon/icon.png" width="24"> Godot Share Plugin
10+
11+
Share Plugin allows sharing of text and images on Android and iOS platforms.
12+
13+
_This plugin has been moved under the umbrella of [Godot SDK Integrations](https://github.com/godot-sdk-integrations) organization in Github. Previously, the plugin was placed under three separate repositories: [Android](https://github.com/cengiz-pz/godot-android-share-plugin), [iOS](https://github.com/cengiz-pz/godot-ios-share-plugin), and [addon interface](https://github.com/cengiz-pz/godot-share-addon)._
14+
15+
<br/>
16+
17+
## <img src="addon/icon.png" width="20"> Installation
18+
_Before installing this plugin, make sure to uninstall any previous versions of the same plugin._
19+
20+
_If installing both Android and iOS versions of the plugin in the same project, then make sure that both versions use the same addon interface version._
21+
22+
There are 2 ways to install this plugin into your project:
23+
- Through the Godot Editor's AssetLib
24+
- Manually by downloading archives from Github
25+
26+
### <img src="addon/icon.png" width="18"> Installing via AssetLib
27+
Steps:
28+
- search for and select the `Share` plugin in Godot Editor
29+
- click `Download` button
30+
- on the installation dialog...
31+
- keep `Change Install Folder` setting pointing to your project's root directory
32+
- keep `Ignore asset root` checkbox checked
33+
- click `Install` button
34+
- enable the plugin via the `Plugins` tab of `Project->Project Settings...` menu, in the Godot Editor
35+
36+
#### <img src="addon/icon.png" width="16"> Installing both Android and iOS versions of the plugin in the same project
37+
When installing via AssetLib, the installer may display a warning that states "_[x number of]_ files conflict with your project and won't be installed." You can ignore this warning since both versions use the same addon code.
38+
39+
### <img src="addon/icon.png" width="18"> Installing manually
40+
Steps:
41+
- download release archive from Github
42+
- unzip the release archive
43+
- copy to your Godot project's root directory
44+
- enable the plugin via the `Plugins` tab of `Project->Project Settings...` menu, in the Godot Editor
45+
46+
<br/>
47+
48+
## <img src="addon/icon.png" width="20"> Usage
49+
Add a `Share` node to your scene and follow the following steps:
50+
- use one of the following methods of the `Share` node to share text or images:
51+
- `share_text(title, subject, content)`
52+
- `share_image(full_path_for_saved_image_file, title, subject, content)`
53+
- Note that the image you want to share must be saved under the `user://` virtual directory in order to be accessible. The `OS.get_user_data_dir()` method can be used to get the absolute path for the `user://` directory. See the implementation of `share_viewport()` method for sample code.
54+
- `share_viewport(viewport, title, subject, content)`
55+
56+
<br/>
57+
58+
## <img src="addon/icon.png" width="20"> Demo
59+
Install and enable `SharePlugin` before running demo.
60+
61+
<br/><br/>
62+
63+
---
64+
65+
# <img src="addon/icon.png" width="24"> Android Share Plugin
66+
67+
<p align="center">
68+
<img width="256" height="256" src="demo/assets/share-android.png">
69+
</p>
70+
71+
72+
## [Android-specific Documentation](android/README.md)
73+
## [AssetLib Entry](https://godotengine.org/asset-library/asset/2542)
74+
75+
<br/><br/>
76+
77+
---
78+
79+
# <img src="addon/icon.png" width="24"> iOS Share Plugin
80+
81+
<p align="center">
82+
<img width="256" height="256" src="demo/assets/share-ios.png">
83+
</p>
84+
85+
## [iOS-specific Documentation](ios/README.md)
86+
## [AssetLib Entry](https://godotengine.org/asset-library/asset/2907)
87+
88+
<br/><br/>
89+
90+
---
91+
# <img src="addon/icon.png" width="24"> All Plugins
92+
93+
| Plugin | Android | iOS |
94+
| :---: | :--- | :--- |
95+
| [Admob](https://github.com/godot-sdk-integrations/godot-admob) | ✅ | ✅ |
96+
| [Deeplink](https://github.com/godot-sdk-integrations/godot-deeplink) | ✅ | ✅ |
97+
| [In-App Review](https://github.com/godot-sdk-integrations/godot-inapp-review) | ✅ | ✅ |
98+
| [Notification Scheduler](https://github.com/godot-sdk-integrations/godot-notification-scheduler) | ✅ | ✅ |
99+
| [Share](https://github.com/godot-sdk-integrations/godot-share) | ✅ | ✅ |
100+
101+
<br/><br/>
102+
103+
---
104+
# <img src="addon/icon.png" width="24"> Credits
105+
106+
Developed by [Cengiz](https://github.com/cengiz-pz)
107+
108+
Android part is based on [Shin-NiL](https://github.com/Shin-NiL)'s [Godot Share plugin](https://github.com/Shin-NiL/Godot-Android-Share-Plugin)
109+
110+
iOS part is based on on: [Godot iOS Plugin Template](https://github.com/cengiz-pz/godot-ios-plugin-template)
111+
112+
Original repository: [Godot Share Plugin](https://github.com/godot-sdk-integrations/godot-share)

0 commit comments

Comments
 (0)