Line 1: Line 1:
If you think you have an '''PageSync ShareFile''' that is interesting for others and you would like to have it show up in the list on the PageSync Special page, you can upload your share file here.
+
If you think you have an '''PageSync ShareFile''' that is interesting for others and you would like to have it show up in the list on the PageSync Special page, then read on.
  
===Rules===
+
===How to add to the PageSync Sharefile repo===
  
* When creating the share file, all necessary form fields must have been filled using the English language.
+
When creating the share file, all necessary form fields must have been filled using the English language.
* Any submitted '''PageSync ShareFile''' will be first screened by the Repository maintainer.
 
* You will always receive a status update on the submission and if it has been approved or not. (and why).
 
  
===How to submit===
+
You can fork https://github.com/Open-CSP/PageSync-SharedFiles. Add your own PageSync Share File in the correct category. Currently we have "General", "Extensions", 'Company", "Open-CSP".
Use the form below to submit your '''PageSync SharedFile'''. Be as descriptive as possible, so everyone understands what you '''PageSync SharedFile''' offers them.
+
Inside the category you create a folder with a valid and logical name. See this as the subcategory. Good change there already is subcategory for e.g. a popular extension. Then you can use that. Example "Extensions/FlexForm". In this folder you can upload your PageSyncShare File. Use the original Filename that PageSync produced!. Add another file with the exact same name but instead .zip use .info.
 +
Use the following text and change it accordingly. Be as descriptive as possible, so everyone understands what your '''PageSync SharedFile''' offers them. This information is displayed on the PageSync Shared Files list.
  
===Submit Form===
+
That's it.
<_form action="addToWiki" enctype="multipart/form-data" messageonsuccess="Your submission was successful." setwikicomment="PageSync FileShare Upload Form">
 
<div class="form-group">
 
<_label for="email">Your email address, so we can email you when it is online</_label><_input placeholder="It is used so we can email you about your submission" class="form-control" type="email" name="email" required="required" />
 
</div>
 
<div class="form-group">
 
<_label for="title">Title</_label><_input placeholder="If you would give your Pagesync Share files a title, what would it be?" class="form-control" type="text" name="title" required="required" /></div>
 
<div class="form-group">
 
<_label for="description">Description</_label><_input class="form-control" placeholder="Describe your PageSync Share file as elaborate as possible." type="textarea" name="description" required="required" />
 
</div>
 
<div class="form-group">
 
<_label for="requirements">If your set of PageSync Share files are depending on certain pre-installed extensions or specific MediaWiki Versions, please list them here. (e.g. Requirement name: MediaWiki. Specific version: 1.35+)</_label>
 
<_instance template-parent="pagesync share file" template="requirement" name="requirements">
 
<div class="form-row">
 
<div class="form-group col-md-6">
 
<_label for="Name">Requirement name</_label><_input class="form-control" type="text" name="Name"/>
 
</div><div class="form-group col-md-6">
 
<_label for="Version">Specific version</_label><_input class="form-control" type="text" name="Version"/>
 
</div>
 
</div>
 
</_instance>
 
</div>
 
<div class="form-group">
 
<_label for="pssf">Upload your file</_label><_input type="file" id="pssf" name="pssf" template="pagesync share file" target="PageSync-Share-File_[filename]" parsecontent="parsecontent" pagecontent="[flexform-template]|Email=[email]|Title=[title]|Description=[description]|requirement=[requirements][/flexform-template]"/>
 
</div>
 
<_input type="submit" class="form-control btn btn-primary" value="Submit your PageSync Share File" />
 
</_form>
 

Revision as of 14:24, 11 October 2022

If you think you have an PageSync ShareFile that is interesting for others and you would like to have it show up in the list on the PageSync Special page, then read on.

How to add to the PageSync Sharefile repo

When creating the share file, all necessary form fields must have been filled using the English language.

You can fork https://github.com/Open-CSP/PageSync-SharedFiles. Add your own PageSync Share File in the correct category. Currently we have "General", "Extensions", 'Company", "Open-CSP". Inside the category you create a folder with a valid and logical name. See this as the subcategory. Good change there already is subcategory for e.g. a popular extension. Then you can use that. Example "Extensions/FlexForm". In this folder you can upload your PageSyncShare File. Use the original Filename that PageSync produced!. Add another file with the exact same name but instead .zip use .info. Use the following text and change it accordingly. Be as descriptive as possible, so everyone understands what your PageSync SharedFile offers them. This information is displayed on the PageSync Shared Files list.

That's it.