examples:builder:singe_attachment

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
examples:builder:singe_attachment [2020/09/15 10:02]
orville [Step 1: Extend the base model] 		examples:builder:singe_attachment [2021/12/09 10:56] (current)
pdsci-admin
Line 2: Line 2:
  
 ====== Single media/file attachment: attachOne ====== ====== Single media/file attachment: attachOne ======
-With the //attachOne// function files like images, movies or documents can be attached to a record of a database table. Media attachments are using built-in relations of OctoberCMS. So it is very easy to implement them.+With the //attachOne// function files like images, movies or documents can be attached to a record of a database table. Media attachments are using built-in relations of WinterCMS. So it is very easy to implement them.
  
 <WRAP tip> <WRAP tip>
 **Todo Cheat Sheet**\\ **Todo Cheat Sheet**\\
   * Add code to model: public $attachOne = ['yourFieldName' => ['System\Models\File', 'public' => false]];   * Add code to model: public $attachOne = ['yourFieldName' => ['System\Models\File', 'public' => false]];
-  * Add new //file upload// widget to form with 'yourFieldName' as field +  * Add new //file upload// widget to the backend form with 'yourFieldName' as field name 
-  * Set allowed file extensions, width and height of image (if image files) +  * Set at least allowed file extensions, width and height of image (if image files) 
 </WRAP> </WRAP>
  
Line 21: Line 21:
 Prerequisites are\\ Prerequisites are\\
   * an installed [[https://octobercms.com/plugin/rainlab-builder|builder plugin]]   * an installed [[https://octobercms.com/plugin/rainlab-builder|builder plugin]]
-  * any source code editor or e.g. the [[https://octobercms.com/plugin/indikator-devtools|Developer Tools]] plugin with built-in Code editor like in the screenshoots+  * any source code editor or e.g. the [[https://octobercms.com/plugin/indikator-devtools|Developer Tools]] plugin with built-in Code editor like to be seen on the screenshoots
   * a database table for records to attach the media to   * a database table for records to attach the media to
   * a form (at least in backend) to display the media   * a form (at least in backend) to display the media
Line 36: Line 36:
 The base model requires to know the type of desired relation as well as the name of the relation. This name can be seen like a field name of a database-table.\\ The base model requires to know the type of desired relation as well as the name of the relation. This name can be seen like a field name of a database-table.\\
  
-The base model is located in the plugin directory, subdirectory //models// using the singular of the related db-table name. In our library example this is:\\+The base model is located in the plugin directory, subdirectory //models// using the singular of the related db-table name. In our example in the namspace //pds// the plugin //library// with a //book// model this is:\\
     /pds/library/models/book.php     /pds/library/models/book.php
  
Line 55: Line 55:
  
 ===== Step 2: Prepare the form ===== ===== Step 2: Prepare the form =====
-Next step is to complete the form with an additional field to upload and display media and/or files:\\+Next step is to complete the form with an additional field - the **File upload** widget to upload and display media and/or files:\\
  
 {{:examples:builder:attachone.1.fields.jpg?direct&960 |}} {{:examples:builder:attachone.1.fields.jpg?direct&960 |}}
Line 64: Line 64:
 Finally, in the backend form view of the plugin, a file can be uploaded by clicking on the //file upload symbol// - the area below the 'Cover Image' title in the example:\\ Finally, in the backend form view of the plugin, a file can be uploaded by clicking on the //file upload symbol// - the area below the 'Cover Image' title in the example:\\
 {{:examples:builder:attachone.5.final-upload.jpg?direct&960 |}} {{:examples:builder:attachone.5.final-upload.jpg?direct&960 |}}
 +<WRAP clear />
 \\ \\
 +Now the form is ready to attach images and/or files to each record.\\
 +----
 \\ \\
- +Back to [[:start|Start Page]]
----- +