About ProcessFileEdit

A ProcessWire module for editing files in the admin area.

Category Admin Helpers
Admin helper modules are those that provide helpful tools, UI enhancements or optimizations to the admin panel (excluding Fieldtype or Inputfield modules).
Release StateBeta
Close to stable, but users are advised to be cautious and test thoroughly.*
Authorsmatjazp, tpr
Module Version1.7.5
Class NameProcessFileEdit
Compatibility2.5, 2.6, 2.7, 3.0
Date AddedNovember 9, 2016
Last UpdatedNovember 23, 2017
Recommended ByNew recommendations may take up to 1 day to appear.

Instructions

This module's files should be placed in /site/modules/ProcessFileEdit/
How to install or uninstall modules

README

ProcessFileEdit

Allow modal editing of files on the filesystem. The list of directories and filesare displayed, clicking on file opens modal window with the codemirror editor. If the file is an image, the viewer is opened in modal. If the file is used as a template, link to the template edit is provided. Intended primarily for superusers, give other users file-edit permission.

This is not the replacement for a full-blown editor. Be aware that if you makechanges to files that cause PW to throws an error in admin, you lose access to this module too and you will need some other means to access the file again!

Options

Directory path

The path to the directory from which to display directory tree. By default it's setto $config->paths->site

File encoding

The encoding used when saving file name. Different operating systems and underlyingfilesystem use different ways of how filenames are stored on the filesystem. This setting allows you to overcome situations when file name become garbled after save operation. Options are: 'Auto detect' (this is default), 'Windows-1250', 'Windows-1252', 'ISO-8859-2', 'PHP's urldecode' and 'none'.

Line endings

Type of line endings to use when saving. CodeMirror returns end-of-line asWindows style end-of-line (\r\n). Here you can set up how to handle this. Default is 'Auto detect' that try to detect original line endings and apply them on save. You may manually set line endings to Windows (\r\n), Linux (\n) or Mac (\r) style.

Extensions filter

Comma separated list of extensions to filter files by. By default "php,module,js,css".

Include or exclude extensions

Select to include or exclude files based on the extensions defined in ExtensionFilter. Include is the default, so files matching extensions will be displayed in directory/file tree.

Backup extension

Extension to use when backing up edited file, for example ".bak" ("." is prepended ifomitted). Leave empty for no backup (this is default).

Dotfiles exclusion

Check to exclude files and folders starting with a dot (.) like .gitignore, .htaccess etc.The default is unchecked. This option also hides the old versions of site modules that were created by Ryan's Upgrades module showing up when browsing /site/modules. You can add "htaccess" and other extensions to the extensions filter to allow those.

Editor height

The height of the editor textarea, the default is "auto", can be any height like "450px".

Line wrapping

Make long lines in the editor wrap. Default is on.

Codemirror theme

List of themes supported by CodeMirror, see demo.The default theme is "default".

Installation

Copy the files to the /site/modules/ProcessFileEdit folder, log in to your ProcessWireadmin and go to the Modules page. Click the Refresh button and then Install. More info at http://modules.processwire.com/install-uninstall/

License

Copyright (c) 2016 Florea Banus George (https://github.com/f-b-g-m/ProcessFileEdit).
Fork by Matjaž Potočnik (https://github.com/matjazpotocnik/ProcessFileEdit).
Big thanks to Roland Toth.
Support forum: https://processwire.com/talk/topic/14276-file-editor/

Licensed under the MIT license. See the LICENSE file for details.

Comments

No comments yet. Be the first to post!

Post a Comment

Your e-mail is kept confidential and not included with your comment. Website is optional.