Textpattern CMS support forum

You are not logged in. Register | Login | Help

#11 2018-12-27 15:58:05

colak
Admin
From: Cyprus
Registered: 2004-11-20
Posts: 7,242
Website

Re: flat scripts in 4.7.2

So let me get this right as I know I am doing something wrong:)

I created a miscellaneous form and called it hello.

In the form I added

<txp:header name="Cache-Control" value=" no-cache, no-store, must-revalidate" />
<p>Hello world!</p>

I guess that the url of the form is http://www.domain.tld/?f=hello but nothing seems to be parsing as visiting the url I only get an empty page.


Yiannis
——————————
neme.org | hblack.net | LABS | State Machines | Respbublika! | NeMe @ github

Offline

#12 2018-12-27 17:20:15

etc
Developer
Registered: 2010-11-11
Posts: 3,157
Website

Re: flat scripts in 4.7.2

colak wrote #315765:

I created a miscellaneous form and called it hello.

Only forms with a media type can be accessed this way, for privacy reasons. Otherwise, any of your pre-4.7.2 forms would be publicly exposed.


etc_[ query | search | pagination | date | tree | cache ]

Offline

#13 2018-12-27 19:14:51

colak
Admin
From: Cyprus
Registered: 2004-11-20
Posts: 7,242
Website

Re: flat scripts in 4.7.2

i see ^^. Intelligent foresight!

I gave the form an html media type and it works according to the label. I wish we had a how-to in the docs explaining all these. The docs and tips websites are great for tag basics and more advanced tag manipulation examples, but we have nowhere else but the forum to document these wonderful features.

I am by no means complaining. I’m just thinking aloud about the possibility of adding a section in the docs but I’m not sure if there will be enough interest from the people here to start a collaborative writing effort to make the docs site a more complete reference destination.


Yiannis
——————————
neme.org | hblack.net | LABS | State Machines | Respbublika! | NeMe @ github

Offline

#14 2018-12-27 21:08:37

Bloke
Developer
From: Leeds, UK
Registered: 2006-01-29
Posts: 8,629
Website

Re: flat scripts in 4.7.2

colak wrote #315784:

I’m not sure if there will be enough interest from the people here to start a collaborative writing effort to make the docs site a more complete reference destination.

I’m interested!

We need to document this stuff, curate the good tips and examples from the forums and put them in the official docs wherever makes most sense. So if you spot any cool examples or tidbits of info that could help, collect them and propose changes either directly committing to the pages if you can, or raise them as issues and then we can fold them into the docs.


The smd plugin menagerie — for when you need one more gribble of power from Textpattern. Bleeding-edge code available on GitHub.

Txp Builders – finely-crafted code, design and Txp

Offline

#15 2018-12-28 08:56:50

colak
Admin
From: Cyprus
Registered: 2004-11-20
Posts: 7,242
Website

Re: flat scripts in 4.7.2

Hi Stef, Unlike tags though this tip is about functionality. I guess that it could be added to FAQ but as features are becoming somewhat cryptic (see Example 8 I added a few weeks ago), the FAQ are becoming slightly irrelevant.

Thinking aloud again

What I would like to see developing is a user manual, presenting screen-shots of the installation process (starting with (s)ftp) to the use of tags when designing complex non blog and gallery sites. At the moment the vanilla front end template is excellent for blogs but it does not demonstrate the power and flexibility of txp as a CMS.

Furthermore, as txp is now and for some time has been a mature software, a tutorial on migrating large sites should also be included. Over 3 and a half years ago, I posted this one on textpattern.tips, but maybe a more generic version is needed.

In addition to the above chapters could include

  • Migrating a site from another blog system to txp (wp, joomla, etc)
  • txp concept basics (this could be a basic tutorial linking to the tag reference)
  • A step by step tutorial on the multi-site functionality (admittedly I have not used this as I still have no idea about what to expect)
  • Creating plugins (there is some documentation on this but is it up to date?)
  • Creating short-codes (There are numerous examples in the forum which I could collect, collate and sanitise).

All the above (except the plugin creation) should be geared for designers and hobbyists as I believe that it is the userbase we need to target for.


Yiannis
——————————
neme.org | hblack.net | LABS | State Machines | Respbublika! | NeMe @ github

Offline

#16 2018-12-28 09:50:56

Bloke
Developer
From: Leeds, UK
Registered: 2006-01-29
Posts: 8,629
Website

Re: flat scripts in 4.7.2

That’s all good stuff, colak.

I’m on board with all of that except the screenshots. I’m of the opinion that screenshots create a rod for our backs because they become out of date faster than words, and the type of users whom they serve (mainly newbies) who might feel comforted by their use then end up feeling uncomfortable because the screenshot doesn’t match the reality.

Let’s figure out how to structure the docs to add the kind of stuff you mention.

Last edited by Bloke (2018-12-28 16:52:46)


The smd plugin menagerie — for when you need one more gribble of power from Textpattern. Bleeding-edge code available on GitHub.

Txp Builders – finely-crafted code, design and Txp

Offline

#17 2018-12-28 11:09:25

jakob
Admin
From: Germany
Registered: 2005-01-20
Posts: 3,435
Website

Re: flat scripts in 4.7.2

colak wrote #315790:

What I would like to see developing is a user manual, presenting screen-shots of the installation process (starting with (s)ftp) to the use of tags when designing complex non blog and gallery sites. At the moment the vanilla front end template is excellent for blogs but it does not demonstrate the power and flexibility of txp as a CMS.

I agree wholeheartedly. I understand, too, that screenshots are hard to maintain but they are undoubtedly a great help for beginners. I know that when I look at other systems, screenshots help me get a handle on what to expect.

In general, I think we could split some of these things across the docs, tips and maybe even mag articles, as some are more examples than reference. Splitting things does, of course, add to the management requirement. There may be potential for a mag issue as quite a bit is new. I thought this might be a good txp-meet-up topic to discuss.

Migrating a site from another blog system to txp (wp, joomla, etc)

Without an import mechanism/format, this is, I think, very much a manual activity at the moment. The old importers worked while the other systems were still very basic. If you have access to the previous system and can control its output or massage its database, you can automate some of that. Building a site from an HTML template is, however, a relevant topic.

txp concept basics (this could be a basic tutorial linking to the tag reference)

I looked for this a few months back and even went as far as looking up Destry’s ‘seminal’ building-blocks articles on the way-back-machine. Things have changed a little since then, though.

A step by step tutorial on the multi-site functionality (admittedly I have not used this as I still have no idea about what to expect)

There are my multi-site installation instructions which must give you a pretty good idea and begin with “Why use a multi-site installation?”.

Creating plugins (there is some documentation on this but is it up to date?)

There are these which are, I believe, relatively up to date.

Creating short-codes (There are numerous examples in the forum which I could collect, collate and sanitise).

There are the docs and some examples in the docs, but I could also imagine examples being great as a category of the textpattern.tips site.

All the above (except the plugin creation) should be geared for designers and hobbyists as I believe that it is the userbase we need to target.

I also agree. The usage / getting started docs are for beginners, the rest should aimed at those with some knowledge of html and making websites.


TXP Builders – finely-crafted code, design and txp

Offline

#18 2018-12-28 16:42:05

Bloke
Developer
From: Leeds, UK
Registered: 2006-01-29
Posts: 8,629
Website

Re: flat scripts in 4.7.2

With regards screenshots (I was rushing when I wrote that, sorry) I should qualify that they should be used sparingly rather than as a matter of course. They do have value!


The smd plugin menagerie — for when you need one more gribble of power from Textpattern. Bleeding-edge code available on GitHub.

Txp Builders – finely-crafted code, design and Txp

Offline

#19 2018-12-28 17:45:28

colak
Admin
From: Cyprus
Registered: 2004-11-20
Posts: 7,242
Website

Re: flat scripts in 4.7.2

Sorry I did not respond. I wanted to read the links posted.

I still have many questions re docs.textpattern.com/installation/multi-site-textpattern. ie

the creation of subdomain

So, the multi-site install can not serve different domains? Further down the tutorial says we can, but this is slightly confusing.

the unpacked file tree to the web root on your webserver

If the above is correct, would the web root be the one where the www domain is served from?

If you chose a database prefix and are using one database for several Textpattern installations, remember to enter it during configuration.

Does this mean that we can have different site designs, sections, categories, url schemas, articles, images, content in general, using just one install?

Also what about migrating multiple sites to multisite administration?

There are the docs and some examples in the docs, but I could also imagine examples being great as a category of the textpattern.tips site.

I have created a short-tags category in the textpattern.tips site, waiting to be populated. I’ll start collecting first.


Yiannis
——————————
neme.org | hblack.net | LABS | State Machines | Respbublika! | NeMe @ github

Offline

#20 2018-12-28 19:11:51

colak
Admin
From: Cyprus
Registered: 2004-11-20
Posts: 7,242
Website

Re: flat scripts in 4.7.2

OK, I have created a short-tags category and written an article on the tips site (currently in drafts). One of the reasons I did not publish it is because textile does not seem to be parsing the tags starting with bc..

Julian, I understand you have publisher rights there, could you take a look?

This issue with textile seems to be appearing just for me and Stef:)


Yiannis
——————————
neme.org | hblack.net | LABS | State Machines | Respbublika! | NeMe @ github

Offline

Board footer

Powered by FluxBB