[addon multiplefileupload] MultipleFileUpload – form control

Dnes se na SVN objevila nová revize s pořadovým číslem 61. Je to poměrně velký balík změn, takže prosím o řádné otestování a bugfixy. Jde o dlouho slibovanou podporu pro více interfaců, takže se nyní jako interface dá přidat do MFU i swfupload, či cokoli jeného. A také přibyla podpora pro fallback. Pod každý uploaderem je odkaz. Po kliknutí se provede fallback o úroveň níže. V distribuci jsou v současné době k dispozici dva interfacy:

1. Uploadify
2. HTML4SingleUpload

Dokumentaci dopíšu v co nejkratším čase. Nejspíš ji rozdělím na více stránek, protože už se ta stránka příšerně rozrostla.

Co znamená interface v prostředí MultipleFileUploaderu?

Je to balíček několika funkcí a šablon, který má za úkol zobrazit interface klientovi a načíst data, která vygeneroval na klientské části. Tyto data předá modelu (driveru). O zbytek se stará MultipleFileUpload.

Interfacy se dají registrovat v booststrapu následujícím způsobem:

MultipleFileUpload::getUIRegistrator()
	->clear()
	->register("MFUUIHTML4SingleUpload")
	->register("MFUUIUploadify");

Jak vypadá třída interface?

class nazevInterfacu extends MFUUIBase /* musí implementovat MFUUIInterface */ {

	/**
	 * Is this upload your upload? (upload from this interface)
	 */
	public function isThisYourUpload() {
		return true nebo false;

		/* tato metoda se volá před zavoláním metody handleUploads a slouží k identifikaci, zda právě probíhající upload proběhl z tohoto interface. Doporučuji klientské části zařadit do nějakého paramateru název interface, pro zaručené rozpoznání. */
	}

    	/**
	 * Handles uploaded files
	 * forwards it to model
	 */
	public function handleUploads() {

		// Načti surová data a předej je modelu.

		// return true způsobí, že se už nebude volat handleUploads od žádného dalšího interface.
		return true; // Skip all next interfaces
	}

	/**
	 * Renders interface to <div>
	 */
	public function render(MultipleFileUpload $upload) {
		/* Vygeneruje HTML interface */

		$template = $this->createTemplate(dirname(__FILE__)."/html.phtml");
		$template->mfu = $upload;
		return $template->__toString(TRUE);
	}

	/**
	 * Renders JavaScript body of function.
	 */
	public function renderInitJavaScript(MultipleFileUpload $upload) {
		/* Vygeneruje JavaScript, který se spustí při inicializaci interface */
		return $this->createTemplate(dirname(__FILE__)."/initJS.js")->__toString(TRUE);
	}

	/**
	 * Renders JavaScript body of function.
	 */
	public function renderDestructJavaScript(MultipleFileUpload $upload) {
		/* Vygeneruje JavaScript, který se spustí při destrukci interface */
		return true;
	}

	/* U obou těchto funkcí se na straně klienta kontroluje návratová hodnota, která musí být true, jinak nepoběhne fallback na další interface. Obě funkce jsou volány ve scope MFUFallbackControlleru, z něj si můžete jednoduše vytáhnout DOM provek přes jeho proměnou rootEl. */
}

MFU na straně klienta – fallbacky

Na straně klienta sedí třída, která se ovládá velmi jednoduše. Najdu se v DOMu objekt, který má ID, které vrací FormControl::getHtmlId(). (většinou něco jako frmNázevFormuláře-názevPolíčka) V něm se ukrývá proměná fallbackCntrl ve které se skrývá instance třídy MFUFallbackController (JavaScript). Ta má několik metod z nich nejdůležitější následující:
fallback – ta přehodí interface o jeden níže. Vyzkoušet si to možete na příkladu na serveru, když si do své konzole FireBugu (či něčeho obdobného) zadáte

document.getElementById("frmform-upload").fallbackCntrl.fallback();

skočí MFU o jeden interface dolů, tedy na HTML4 upload a protože už není k dispozici další fallback zmizí automaticky i odkaz na fallback.

Dnes byla vydána revize 69, byl změněn způsob registrace queues modelu. (modelu, který ukládá data) Prosím změňte způsob registrace v bootstrapu na

MultipleFileUpload::setQueuesModel(new MFUQueuesDibi());

proměnná queuesModel je nyní protected. Je to kvůli internímu lazy loadingu, díky kterému se nyní při použití alternativního driveru nenatahuje i SQLite model. Žádný jiný vliv na funkčnost by tato zněmna neměla mít.

Ahoj,
nenašel by se prosím někdo, kdo má upraven MFU pro PHP 5.3 ve verzi Nette s namespaci (0.9.3)? Snažím se jej upravit, ale tápu v něm a nedaří se mi to. Děkuji

@Despiq: prosím pošli mi to mail. Můj mail máš u sebe na mailu. :)

Ahoj,
používám verzi MFU na PHP 5.3 a vše mi jde v pohodě. Když si chci ale upravit uploadify tak, aby mi ihned po vybrání souboru ten soubor začalo kopírovat, nastane chyba – v logu mám následující:

PHP Warning:  SQLiteDatabase::query(): database schema has changed in C:\xampp\htdocs\upload\app\controls\MultipleFileUpload\Models\SQLite\MFUQueuesSQLite.php on line 56

PHP Warning:  SQLiteDatabase::query(): cannot commit - no transaction is active in C:\xampp\htdocs\upload\app\controls\MultipleFileUpload\Models\SQLite\MFUQueuesSQLite.php on line 56

PHP Fatal error:  Uncaught exception 'InvalidStateException' with message 'Can't execute queury: 'END TRANSACTION'. error: cannot commit - no transaction is active' in C:\xampp\htdocs\upload\app\controls\MultipleFileUpload\Models\SQLite\MFUQueuesSQLite.php:58

Používám Xampp s PHP ve verzi 5.3. Z hlášky vidím, že je problém s SQLite, ale nevím, jak jej doinstalovat.. ale taky mi vrtá hlavou, jaktože se při pouhé změně způsobu odeslání souboru vynořila tahle hláška a při běžném odeslání přes SUBMIT to šlo v pohodě… Děkuji za případné objasnění

Už mě moc nenapadá, jak se z tohoto problému vymotat – tak sem zkusím pastnout tu miniaplikaci (hned po rozbalení jede). Mám tam nastaven onen automatický start po výběru souboru, který ne a ne chodit (s běžným submit odesláním jde)… Za jakékoli tipy na řešení budu rád

Ale stejně si myslím, že to není moc user-friendly, on jen vybere soubory a ty už mu je stahuješ z počítače. Já si před odesláním formuláře ty data kontroluji. Pokud už by to bylo odeslané, nešlo by to.

Tak to jsi mi udělal velikou radost. Protože vidět, že ta práce nebyla k ničemu je opravdu potešující. ;)

A samozřejmě jménem komunity Nette, komunity MFU a mým jménem Ti děkuji za spolupráci!

Jsem teď mimo pracoviště, tedy zatím to dokumentace nepřidám. Více uploaderů v jednom formuláři by nemělo dělat problém, dokonce jsem to tak i jednou používat a fungovalo to. To bude nejspíš někde nějaký překlep. (můj)

Náš to v distribici. Prosím veškteré změny, které budš chtít provést v pluginu, mi posílej na mail již s novou adresářovou strukturou, která je teď v distribuci. Děkuji moc za spolupráci!

Lopo napsal(a):

narazil som na webe na http://www.shift8creative.com/…r/index.html – ak by to pomohlo pri dalsom vyvoji aspon nejakou inspiraciou

Nepřišel jsem v demu na to jak vybrat více adresářů najednou (na jedno otevření průzkumníka). Zdá se, že to dialogové okno to neumožňuje. Nezdá se mi to jako žhavý kandidát pro přidání interfacu. Plupload by byl určitě větší výzva :o)

na Plupload se tesim, je sexy a multi technologickej

+1 nikomu v této chvíli nepomůže. Čeká se na někoho, kdo přepíše toto do podoby interface.

To omezení se nastavuje z omezení PHPka. Tedy nic s tím neudělám. Ale informační hlášku by to chtělo. Že bychom tam přidali nějaký callback, který by udělal flash-message?

hmmm, asi vím o čem mluvíš. Tak to je spíše bug. Pokusím se to opravit (ale ne hned).

Stačí stáhnout nejnovější revizi a mít načtené alespoň dva interfaces. (výchozí stav)

To bude asi nějaký bug v klientské části MFU, pokud chcete rychlé řešení, debugujte a potom se o řešení podělte zde na fóru. Já se k tomu dostanu až poměrně za dlouho. (měsíc až půl roku)

Vyki napsal(a):
Nevím, ale osobně ve formuláři, který není jenom pro upload samotný mám dvě tlačítka. To, které submituje upload, form nevaliduje

nj, jenže já potřebuju, aby se fotky nahrály jen v případě jsou-li data v pořádku, tedy připraveny pro uložení do databáze.

Honza Kuchař napsal(a):
To bude asi nějaký bug v klientské části MFU, pokud chcete rychlé řešení, debugujte a potom se o řešení podělte zde na fóru. Já se k tomu dostanu až poměrně za dlouho. (měsíc až půl roku)

můžu zkusit, ale v debugování nejsem zrovna zdatný, pochybuji, že něco objevím ;)

Konečná verze není, proto je to na SVN. Ale poradím ti:

1. vytvoř nějakou složku u sebe na PC
2. na ni klikni pravým tlačítkem a dej Checkout (případně TortoiseSVN->checkout)
3. zadej adresu SVN repozitáře, kterou najdeš na stránce s dokumentací doplňku
4. OK
5. čekej
6. Máš to stažené
7. OK = zavřít

Multiplefileupload se mi nezobrazi v ty flash forme, kde lze vybrat vice souborů, jen pouze 5 file inputů.
Nevíš čím to může být? Zkoušeno ve FF a Opeře.

Nemám v bootstrap.php robot loader, jinak vše mám podle "":https://componette.org/search/?… .

Vím o problému v IE7, kde to nešlape (v IE 6 to překvapivě funguje), ale zkus debugovat. Třeba firebugem ve FF, mrkni jesti se při natahování některých JS a SWF souborů nevyhazuje 404.

Editoval Vyki (30. 9. 2010 22:41)

co zkusit IE tester?

IE7 zrusit, je to stejnej srac jako IE6 a v necem jeste horsi, proboha upgradujte to tem lidem co to pouzivaj dyt je to 4 roky stary a kristepane ono to pouziva jeste 14% lidi

to mame za trest, jen nevim co jsme mrkvosoftu udelali

Asi se to spustí, než je ta třída načtená…

To je opravdu zváštní… Ještě se mi to nestalo. Takže bych to tipoval na Nette 2.0-dev nebo bych zkusil přehodit pořadí

MultipleFileUpload::setQueuesModel(new MFUQueuesDibi());
MultipleFileUpload::getUIRegistrator()
    ->clear()
    ->register('MFUUISwfupload');
MultipleFileUpload::register();

Ale možná to nehraje roli, moc si nepamatuji, jestli to může mít nějaký vliv. Spíše asi ne, ale je to první co mě napadlo.