Creating and deleting dataobjects from the front end

29 June 2012 | stallain | DataObjects, Relations | Supports v2.4

13 5

One of my clients wanted a clear interface from which he could easily attach downloadable files to some pages of his site. Instead of using modelAdmin and granting him an access to Silverstripe admin panel, I chose to create a front-end page showing a simple upload form, a list of the files previously uploaded to the server, and a delete button for each of them.

First steps

Creating the "Programme" page the uploaded files will be attached to, and the "Telechargement" dataobject for the uploaded file

mysite/code/Programme.php

Each "programme" can have many "telechargements" :

<?php

class Programme extends Page {

	public static $has_many = array(
		'Telechargements'=>'Telechargement'
		);
	
	}

mysite/code/Telechargement.php

Each "telechargement" can be attached to only one "programme" :

<?php

class Telechargement extends DataObject {
	
	public static $db = array(
		'Title'=>'Text'
		);

	static $has_one = array(
		'MonProgramme' => 'Programme',
		'Fichier' => 'File',
		'MaPageTelechargement' => 'PageTelechargement'
		);
	
	}

themes/blackcandy/templates/Layout/Programme.ss

Shows a list of the downloadable files :

<h1>$Title</h1>

$Content

<% if Telechargements %>

	<p>Downloadable files :</p>
	
	<ul>
	<% control Telechargements %>
		<li><a href="<% control Fichier %>$Link<% end_control %>" target="_blank">$Title</a></li>
	<% end_control %>
	</ul>

<% end_if %>

Second step

Creating the "PageTelechargement" page for the upload form

mysite/code/PageTelechargement.php

<?php

class PageTelechargement extends Page {
	
	public static $has_many = array(
		'Telechargements' => 'Telechargement'
		);
	
	}
	
class PageTelechargement_Controller extends Page_Controller {

	public static $allowed_actions = array (
	'UploadForm'
	);

	function UploadForm() {
		
		// retrieve all the "Programme" pages
		$myDoSet = DataObject::get("Programme","","Title ASC");
		if($myDoSet){$map = $myDoSet->toDropDownMap();}

		// form fields			
		$fields = new FieldSet(
			new TextField('Title', 'File name :'),
			new FileField('Fichier', 'Upload file :','','','','telechargements' ),
			// The user can tick a radio button to choose the programme related to the uploaded file
			new OptionsetField('MonProgrammeID','Related programme :', $map),
			);
			
		$actions = new FieldSet(    
			new FormAction('UploadFiles', 'Télécharger')
			);
	 
		// all fields are required
		$validator = new RequiredFields('Title', 'Fichier', 'MonProgrammeID');
		
		// return form
		$form = new Form($this, 'UploadForm', $fields, $actions, $validator);			
		return $form;
		
		}

	// write a new "Telechargement" dataobject into the database
	function UploadFiles($data, $form) {
		$transfert = new Telechargement();
		$form->saveInto($transfert);
		$transfert->write();
		Director::redirectBack();

		}
	}

themes/blackcandy/templates/Layout/PageTelechargement.ss

Our template so far :

<h1>$Title</h1>
$Content
$UploadForm

Third step

Probably the most interesting part, which involves rules and actions : creating a function to delete a "Telechargement" dataobject previously created

mysite/code/PageTelechargement.php

<?php

class PageTelechargement extends Page {
		
	...
	
	}
	
class PageTelechargement_Controller extends Page_Controller {

	public static $allowed_actions = array (
	'UploadForm',
	// allow a new action
	'delete'
	);

	function UploadForm() {
		...
		}

	function UploadFiles($data, $form) {
		...
		}
	
	// create our delete function
	function delete(){
		// get the ID parameter in the URL
		$Params = $this->getURLParams();
		// get the dataobject corresponding to the ID
		if ($downloadToDelete = DataObject::get_by_id('Telechargement', (int)$Params['ID']))
		// delete the dataobject found and go back to the page
		{$downloadToDelete->delete();}
		Director::redirectBack();
		}
		
	}

mysite/_config.php

We now need to write our rule. URLs ending with ".../delete/ID" will be handled by the "PageTelechargement" controller and the delete function will be called :

mysite/_config.php

We now need to write our rule. URLs ending with ".../delete/ID" will be handled by the "PageTelechargement" controller and the delete function will be called :

Director::addRules(100, array(
	'delete//$ID!' => 'PageTelechargement_Controller'
));

themes/blackcandy/templates/Layout/PageTelechargement.ss

That's it. Now, we can create a list showing the uploaded dataobjects in the template and add a link to delete each of them :

<h1>$Title</h1>
$Content

<ul>
<% control Telechargements %>
<li>
Name : $Title -
File : <% control Fichier %><a href="$Link">$Name</a><% end_control %> -
Programme : <% control MonProgramme %><a href="$Link">$Title</a><% end_control %> -
<a href="{$Top.Link}delete/$ID" title="">delete ?</a>
</li>
<% end_control %>	
</ul>
	
$UploadForm

A simplified ComplexTableField for the front end !